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)

另请参阅

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter