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