IPrintOemUI::GetInfo メソッド (prcomoem.h)

  • [アーティクル]

ユーザー インターフェイス プラグインの IPrintOemUI::GetInfo メソッドは、識別情報を返します。

構文

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

パラメーター

dwMode

次の呼び出し元から指定された整数定数のいずれかを格納します。

OEMGI_GETREQUESTEDHELPERINTERFACES

IPrintOemUI::P ublishDriverInterface メソッドを、IPrintCoreHelperPS インターフェイスまたは IPrintCoreHelperUni インターフェイスを実装するオブジェクトを指すパラメーター pIUnknown を使用して呼び出す必要がある場合、メソッドは OEMPUBLISH_IPRINTCOREHELPER のビット フラグ値をバッファー pBuffer に書き込む必要があります。

OEMGI_GETSIGNATURE

メソッドは、一意の 4 バイト識別シグネチャを返す必要があります。 また、OEMCUIPPARAM 構造体の pOEMOptItems メンバーの説明で説明されているように、プラグインはこの署名を OPTITEM 構造体に配置する必要があります。

OEMGI_GETVERSION

メソッドは、ユーザー インターフェイス プラグインのバージョン番号を DWORD として返す必要があります。 バージョン形式は開発者が定義しています。

pBuffer

dwMode で指定された情報を受け取るために割り当てられたメモリへの呼び出し元提供のポインター。

cbSize

pBuffer が指すバッファーの呼び出し元指定サイズ。

pcbNeeded

pBuffer が指すバッファーに書き込まれたバイト数を受け取る場所への呼び出し元指定のポインター。

戻り値

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

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

注釈

ユーザー インターフェイス プラグインは、 メソッドを IPrintOemUI::GetInfo 実装するために必要です。このメソッドは、プラグインが読み込まれた直後に呼び出されます。 メソッドは、指定された情報を pBuffer で指定されたアドレスに書き込み、返された情報のサイズ (バイト単位) を pcbNeeded で指定された場所に書き込むことで、指定された情報を返す必要があります。

pBuffer が NULL の場合、メソッドは pcbNeeded を使用して、指定された情報を格納するために必要なバイト数を返す必要があります。

ユーザー インターフェイス プラグインの作成とインストールの詳細については、「 Microsoft のプリンター ドライバーのカスタマイズ」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)

こちらもご覧ください

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo