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
Library Prntvpt.lib
DLL Prntvpt.dll

另请参阅

打印架构

打印后台处理程序 API 函数

打印