描述
检索打印机的格式符合XML打印模式的功能。
C++ 语法
HRESULT PTGetPrintCapabilities( __in HPTPROVIDER hProvider, __in IStream *pPrintTicket, __in IStream *pCapabilities, __out BSTR *pbstrErrorMessage ); |
PowerBASIC 语法
FUNCTION PTGetPrintCapabilities ( _ BYVAL hProvider AS DWORD, _ BYVAL pPrintTicket AS IStream, _ BYVAL pCapabilities AS IStream, _ BYREF pbstrErrorMessage AS STRING _ ) AS LONG |
参数
hProvider
[in]要检索其打印功能的打开的提供程序的句柄。该句柄由PTOpenProvider或PTOpenProviderEx功能返回。
pPrintTicket
[in]指向一个流的指针，其搜索位置位于打印票据内容的开头。此参数可以为NULL。
pCapabilities
[in]从当前查找位置开始，指向要写入打印功能的流的指针。
pbstrErrorMessage
[out]指向一个字符串的指针，指定对pPrintTicket无效的内容（如果有）。如果它有效，则为NULL。
返回值
如果操作成功，返回值为S_OK。
如果hProvider在另一个线程中打开，则HRESULT为E_INVALIDARG。
如果pPrintTicket不符合打印模式，则HRESULT为E_PRINTTICKET_FORMAT。
如果功能不符合打印模式，则HRESULT是E_PRINTCAPABILITIES_FORMAT。
如果hProvider以不同的线程打开，则HRESULT是E_INVALIDARG。
否则，将在HRESULT中返回另一个错误代码。
备注
hProvider必须是在与用于此函数的线程相同的线程中打开的句柄。
当驱动程序产生根据当前设置而不同的打印机功能时，打印机驱动程序使用pPrintTicket值（当该值不为NULL时）创建设置。
当函数返回时，pPrintTicket的查询位置在打印票据内容的末尾，并且搜索位置功能位于流的末尾。如果呼叫者使用功能的内存流，例如由CreateStreamOnHGlobal创建的流，则呼叫者负责在读取数据之前重置查找位置。
引用文件 #INCLUDE Once
Prntvpt.inc