共用方式為


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 關閉。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 prntvpt.h
程式庫 Prntvpt.lib
Dll Prntvpt.dll

另請參閱

列印架構

列印多工緩衝處理器 API 函式

列印