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 パラメーターに関連付けられているプリンター ハンドルを閉じないようにする必要があります。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | prcomoem.h (Prcomoem.h を含む) |