描述
打开一个打印机票提供者的实例。
C++ 语法
HRESULT PTOpenProvider( __in PCWSTR pszPrinterName, __in DWORD version, __out HPTPROVIDER *phProvider ); |
PowerBASIC 语法
FUNCTION PTOpenProvider ( _ BYVAL pszPrinterName AS DWORD, _ BYVAL version AS DWORD, _ BYREF pbstrErrorMessage AS DWORD _ ) AS LONG |
参数
pszPrinterName
[in]指向打印队列全名的指针。
version
[in]呼叫者请求的打印模式的版本。
phProvider
[out]指向提供程序句柄的指针。
返回值
如果操作成功，则返回值为S_OK，否则HRESULT包含错误代码。
备注
注意这是一个阻止或同步功能，可能不会立即返回。How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation梖actors that are difficult to predict when writing an application.从管理与用户界面交互的线程调用此函数可能会使应用程序无响应。
pszPrinterName必须是全名，而不是可能在DEVMODE中显示的截断的名称。
Print Schema的第一个版本随Windows Vista发布，是版本1。如果不支持版本，则此操作将失败。与PTOpenProviderEx对比起来，即使它仅支持早于请求的版本，它也打开一个提供者。
为了避免资源泄露，必须PTCloseProvider关闭phProvider.
引用文件 #INCLUDE Once
Prntvpt.inc