Share via

PTOpenProvider 関数 (prntvpt.h)

  • [アーティクル]

印刷チケット プロバイダーのインスタンスを開きます。

構文

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

パラメーター

[in] pszPrinterName

印刷キューの完全な名前へのポインター。

dwVersion

呼び出し元によって要求された 印刷スキーマ のバージョン。

[out] phProvider

プロバイダーのハンドルへのポインター。

戻り値

操作が成功した場合、戻り値はS_OK。それ以外の場合、 HRESULT にはエラー コードが含まれます。

COM エラー コードの詳細については、「エラー処理」を参照してください。

注釈

メモ これはブロック関数または同期関数であり、すぐには返されない可能性があります。 この関数が返す速度は、ネットワークの状態、プリント サーバーの構成、プリンター ドライバーの実装などの実行時の要因によって異なります。これは、アプリケーションの作成時に予測が困難な要因です。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。
 
pszPrinterName は、 DEVMODE に表示される可能性があるため、切り捨てられた名前ではなく、完全な名前である必要があります。

印刷スキーマの最初のバージョンは Windows Vista でリリースされ、バージョン 1 です。 バージョンがサポートされていない場合、この操作は失敗します。 これは PTOpenProviderEx と対照的に、要求より前のバージョンのみをサポートしている場合でもプロバイダーを開きます。

リソース リークを回避するには、 ptCloseProvider を使用して phProvider を閉じる必要があります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー prntvpt.h
Library Prntvpt.lib
[DLL] Prntvpt.dll

こちらもご覧ください

印刷スキーマ

印刷スプーラー API 関数

印刷