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 对比，PTOpenProviderEx 打开提供程序，即使它仅支持早于请求的版本。

为了避免资源泄漏， phProvider 必须使用 PTCloseProvider 关闭。