次の方法で共有

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

  • [アーティクル]

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

構文

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

パラメーター

[in] hPrinter

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

[out] ppVersions

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

[out] cVersions

ppVersionsが指す配列内の要素の数を受け取る変数へのポインター。

戻り値

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

備考

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

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

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

必要条件

要件 価値
ヘッダー prdrvcom.h (Prdrvcom.h を含む)

関連項目

IPrintTicketProvider の

IPrintTicketProvider::BindPrinter