共用方式為

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 錯誤碼的詳細資訊，請參閱 錯誤處理。

備註

注意 這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於運行時間因素，例如網路狀態、列印伺服器設定和印表機驅動程序實作—撰寫應用程式時難以預測的因素。 從管理與使用者介面互動的線程呼叫此函式，可能會使應用程式看起來沒有回應。
 
pszPrinterName 參數必須是完整名稱，而不是在 DEVMODE 中顯示的截斷名稱。

第一個版本的列印架構是使用 Windows Vista 發行，而且是第 1 版。 如果列印票證提供者不支援 prefVersion，PTOpenProviderEx 已成功開啟句柄，並在 usedVersion 中傳回舊版。

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

規格需求

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

另請參閱

列印架構

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

列印