通过

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关联的打印机句柄。

要求

要求 价值
标头 prdrvcom.h （包括 Prdrvcom.h）

另请参阅

IPrintTicketProvider2

IPrintTicketProvider2：：BindPrinter