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 ，即使它只支援早於要求的版本，也會開啟提供者。

若要避免資源流失， phProvider 必須使用 PTCloseProvider 關閉。