PTOpenProviderEx 関数 (prntvpt.h)
印刷チケット プロバイダーのインスタンスを開きます。
構文
HRESULT PTOpenProviderEx(
[in] PCWSTR pszPrinterName,
DWORD dwMaxVersion,
DWORD dwPrefVersion,
[out] HPTPROVIDER *phProvider,
[out] DWORD *pUsedVersion
);
パラメーター
[in] pszPrinterName
印刷キューの完全な名前へのポインター。
dwMaxVersion
呼び出し元がサポートする 印刷スキーマ の最新バージョン。
dwPrefVersion
呼び出し元によって要求された印刷スキーマのバージョン。
[out] phProvider
プロバイダーのハンドルへのポインター。
[out] pUsedVersion
印刷チケット プロバイダーが使用する印刷スキーマのバージョンへのポインター。
戻り値
操作が成功した場合、戻り値はS_OK。それ以外の場合、 HRESULT にはエラー コードが含まれます。
COM エラー コードの詳細については、「エラー処理」を参照してください。
注釈
メモ これはブロック関数または同期関数であり、すぐには返されない可能性があります。 この関数が返す速度は、ネットワークの状態、プリント サーバーの構成、プリンター ドライバーの実装などの実行時の要因によって異なります。これは、アプリケーションの作成時に予測が困難な要因です。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。
印刷スキーマの最初のバージョンは Windows Vista でリリースされ、バージョン 1 です。 印刷チケット プロバイダーが prefVersion をサポートしていない場合、 PTOpenProviderEx は ハンドルを正常に開き、 usedVersion で以前のバージョンを返します。
リソース リークを回避するには、 ptCloseProvider を使用して phProvider を閉じる必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | prntvpt.h |
| Library | Prntvpt.lib |
| [DLL] | Prntvpt.dll |