IPrintOemPrintTicketProvider::GetSupportedVersions 方法 (prcomoem.h)
IPrintOemPrintTicketProvider::GetSupportedVersions 方法检索插件提供程序支持的打印架构的主要版本。
语法
HRESULT GetSupportedVersions(
[in] HANDLE hPrinter,
[out] INT * [] ppVersions,
[out] INT *cVersions
);
参数
[in] hPrinter
打印设备的句柄。
[out] ppVersions
指向变量的指针,该变量接收版本号数组中第一个元素的地址。 数组中的版本号可以按任意顺序显示。 有关此参数的详细信息,请参阅以下“备注”部分。
[out] cVersions
指向变量的指针,该变量接收 *ppVersions 指向的数组中的元素数。
返回值
如果操作成功,IPrintOemPrintTicketProvider::GetSupportedVersions 应返回S_OK。 否则,此方法应返回标准 COM 错误代码。
注解
IPrintOemPrintTicketProvider::GetSupportedVersions 返回提供程序接口支持的打印架构的主版本号。 (当前唯一定义的版本号为 1.) 提供程序可以省略中间版本。
插件负责分配 ppVersions 参数指向的数组内存。 插件应使用 Microsoft Windows SDK 文档) 中所述的 CoTaskMemAlloc 函数 (分配此内存,但它不负责释放此内存。
在调用 IPrintOemPrintTicketProvider::BindPrinter 方法之前,可以调用 IPrintOemPrintTicketProvider::GetSupportedVersions。 因此,OEM 插件提供程序不应关闭与 hPrinter 参数关联的打印机句柄。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (包括 Prcomoem.h) |