IPrintCoreUI2::D rvGetDriverSetting メソッド (prcomoem.h)

[アーティクル]
02/29/2024

メソッドは IPrintCoreUI2::DrvGetDriverSetting 、Pscript5 ユーザーインターフェイスプラグインがプリンター機能やその他の内部情報の現在の状態を取得できるように、Windows XP Pscript5 ドライバーによって提供されます。

構文

HRESULT DrvGetDriverSetting(
  PVOID  pci,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

パラメーター

pci

OEMUIOBJ 構造体への呼び出し元が指定したポインター。

Feature

オプション設定が返されるプリンター機能を識別する呼び出し元指定の値。これは、次の「解説」セクションで説明するように、文字列ポインターまたは定数のいずれかになります。

pOutput

指定された情報を受け取るバッファーへの呼び出し元提供のポインター。

cbSize

pOutput が指すバッファーの呼び出し元が指定したサイズ (バイト単位)。

pcbNeeded

要求された情報を格納するために必要な最小バッファーサイズを受け取る場所への呼び出し元指定のポインター。

pdwOptionsReturned

pOutput に配置されたオプション文字列の数を受け取る場所への呼び出し元指定のポインター。

戻り値

このメソッドは、次のいずれかの値を返す必要があります。

リターンコード	説明
S_OK	操作が成功しました。
E_FAIL	操作が失敗しました。
E_NOTIMPL	このメソッドは実装されていません。

注釈

このメソッドは IPrintOemDriverUI COM インターフェイスから継承され、コアドライバーの標準 UI ページを完全に置き換えない Windows XP 以降の Pscript5 UI プラグインでのみ呼び出すことができます。これは、UI プラグインの IPrintOemUI::D ocumentPropertySheets および IPrintOemUI::D evicePropertySheets 関数とそのプロパティシートコールバックルーチン中にサポートされます。このメソッドがサポートされている場合、 IPrintOemDriverUI::D rvGetDriverSetting と同じ動作になります。サポートされていない場合、このメソッドはE_NOTIMPLを返す必要があります。