IPrintTicketProvider2::GetSupportedVersions メソッド (prdrvcom.h)

  • [アーティクル]

IPrintTicketProvider2::GetSupportedVersions メソッドは、プラグイン プロバイダーでサポートされている印刷スキーマのメジャー バージョン番号を取得します。

構文

HRESULT GetSupportedVersions(
  [in]  IN HANDLE    hPrinter,
  [out] OUT INT * [] ppVersions,
  [out] OUT INT      *cVersions
);

パラメーター

[in] hPrinter

印刷デバイスのハンドル。

[out] ppVersions

バージョン番号の配列の最初の要素のアドレスを受け取る変数へのポインター。 配列内のバージョン番号は、任意の順序で表示できます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。

[out] cVersions

ppVersions によって指される配列内の要素の数を受け取る変数へのポインター。

戻り値

操作が成功した場合、IPrintTicketProvider2::GetSupportedVersions は S_OK を返す必要があります。 メモリやその他のリソースがないためにこのメソッドが失敗した場合は、標準の COM エラー コードを返す必要があります。

注釈

IPrintTicketProvider2::GetSupportedVersions は、プロバイダー インターフェイスでサポートされている印刷スキーマのメジャー バージョン番号を返します。 現在定義されているバージョン番号は 1 のみです。 プロバイダーは中間バージョンを省略できます。

プラグインは、 ppVersions パラメーターによって指される配列メモリを割り当てる役割を担います。 プラグインは、Microsoft Windows SDKドキュメントで説明されている CoTaskMemAlloc 関数を使用してこのメモリを割り当てる必要がありますが、プラグインはこのメモリを解放する責任を負いません。

IPrintTicketProvider2::GetSupportedVersions は IPrintTicketProvider2::BindPrinter メソッドを呼び出す前に呼び出すことができるため、OEM プラグイン プロバイダーは、hPrinter パラメーターで渡されるハンドルに基づいてバージョン サポートをチェックする必要があります。 その結果、OEM プラグイン プロバイダーは 、hPrinter に関連付けられているプリンター ハンドルを閉じないようにする必要があります。

要件

要件 値
Header prdrvcom.h (Prdrvcom.h を含む)

こちらもご覧ください

IPrintTicketProvider2

IPrintTicketProvider2::BindPrinter