IPrintOemPrintTicketProvider::GetSupportedVersions メソッド (prcomoem.h)
IPrintOemPrintTicketProvider::GetSupportedVersions メソッドは、プラグイン プロバイダーでサポートされている印刷スキーマのメジャー バージョンを取得します。
構文
HRESULT GetSupportedVersions(
[in] HANDLE hPrinter,
[out] INT * [] ppVersions,
[out] INT *cVersions
);
パラメーター
[in] hPrinter
印刷デバイスへのハンドル。
[out] ppVersions
バージョン番号の配列の最初の要素のアドレスを受け取る変数へのポインター。 配列内のバージョン番号は、任意の順序で表示できます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。
[out] cVersions
*ppVersions によって指される配列内の要素の数を受け取る変数へのポインター。
戻り値
操作が成功した場合、IPrintOemPrintTicketProvider::GetSupportedVersions はS_OKを返す必要があります。 それ以外の場合、このメソッドは標準の COM エラー コードを返す必要があります。
注釈
IPrintOemPrintTicketProvider::GetSupportedVersions は、プロバイダー インターフェイスでサポートされている印刷スキーマのメジャー バージョン番号を返します。 (現在定義されているバージョン番号は 1 のみです)。プロバイダーは中間バージョンを省略できます。
プラグインは、 ppVersions パラメーターによって指される配列メモリを割り当てる役割を担います。 プラグインは、CoTaskMemAlloc 関数 (Microsoft Windows SDK ドキュメントで説明) を使用してこのメモリを割り当てる必要がありますが、このメモリを解放する責任はありません。
IPrintOemPrintTicketProvider::GetSupportedVersions は、 IPrintOemPrintTicketProvider::BindPrinter メソッドが呼び出される前に呼び出すことができます。 その結果、OEM プラグイン プロバイダーは 、hPrinter パラメーターに関連付けられているプリンター ハンドルを閉じないようにする必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | prcomoem.h (Prcomoem.h を含む) |