IPrintTicketProvider2::GetSupportedVersions 方法 (prdrvcom.h)
IPrintTicketProvider2::GetSupportedVersions 方法检索插件提供程序支持的打印架构的主版本号。
语法
HRESULT GetSupportedVersions(
[in] IN HANDLE hPrinter,
[out] OUT INT * [] ppVersions,
[out] OUT INT *cVersions
);
参数
[in] hPrinter
打印设备的句柄。
[out] ppVersions
指向变量的指针,该变量接收版本号数组中第一个元素的地址。 数组中的版本号可以按任意顺序显示。 有关此参数的详细信息,请参阅以下“备注”部分。
[out] cVersions
指向变量的指针,该变量接收 ppVersions 指向的数组中的元素数。
返回值
如果操作成功,IPrintTicketProvider2::GetSupportedVersions 应返回S_OK。 如果此方法由于内存或其他资源不足而失败,应返回标准 COM 错误代码。
注解
IPrintTicketProvider2::GetSupportedVersions 返回提供程序接口支持的打印架构的主版本号。 当前唯一定义的版本号为 1。 提供程序可以省略中间版本。
插件负责分配 ppVersions 参数指向的数组内存。 插件应使用 Microsoft Windows SDK 文档中介绍的 CoTaskMemAlloc 函数分配此内存,但插件不负责释放此内存。
由于可以在调用 IPrintTicketProvider2::BindPrinter 方法之前调用 IPrintTicketProvider2::GetSupportedVersions,因此 OEM 插件提供程序必须基于 hPrinter 参数中传递的句柄检查版本支持。 因此,OEM 插件提供程序不应关闭与 hPrinter 关联的打印机句柄。
要求
要求 | 值 |
---|---|
Header | prdrvcom.h (包括 Prdrvcom.h) |