IPrintTicketProvider：：GetSupportedVersions 方法 (prdrvcom.h)

  • 项目

IPrintTicketProvider：：GetSupportedVersions 方法检索插件提供程序支持的打印架构的主版本号。

语法

HRESULT GetSupportedVersions(
  [in]  IN HANDLE    hPrinter,
  [out] OUT INT * [] ppVersions,
  [out] OUT INT      *cVersions
);

参数

[in] hPrinter

打印设备的句柄。

[out] ppVersions

指向一个变量的指针，该变量接收版本号数组的第一个元素的地址。 数组中的版本号可以按任意顺序显示。 有关此参数的详细信息，请参阅以下“备注”部分。

[out] cVersions

指向变量的指针，该变量接收 ppVersions 指向的数组中的元素数。

返回值

如果操作成功，IPrintTicketProvider：：GetSupportedVersions 应返回S_OK。 如果此方法由于内存或其他资源不足而失败，则应返回标准 COM 错误代码。

注解

IPrintTicketProvider：：GetSupportedVersions 返回提供程序接口支持的打印架构的主版本号。 当前唯一定义的版本号为 1。 提供程序可以省略中间版本。

插件负责分配 ppVersions 参数指向的数组内存。 插件应使用 Microsoft Windows SDK 文档中所述的 CoTaskMemAlloc 函数分配此内存，但插件不负责释放此内存。

由于可以在调用 IPrintTicketProvider：：BindPrinter 方法之前调用 IPrintTicketProvider：：GetSupportedVersions，因此 OEM 插件提供程序必须基于 hPrinter 参数中传递的句柄检查版本支持。 因此，OEM 插件提供程序不应关闭与 hPrinter 关联的打印机句柄。

要求

要求 值
Header prdrvcom.h (包括 Prdrvcom.h)

另请参阅

IPrintTicketProvider

IPrintTicketProvider：：BindPrinter