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)

另请参阅

IPrintTicketProvider2

IPrintTicketProvider2::BindPrinter