Метод 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 . Подключаемый модуль должен выделять эту память с помощью функции CoTaskMemAlloc (описанной в документации по Microsoft Windows SDK), но он не отвечает за освобождение этой памяти.

IPrintOemPrintTicketProvider::GetSupportedVersions можно вызвать перед вызовом метода IPrintOemPrintTicketProvider::BindPrinter . В результате поставщик подключаемого модуля OEM не должен закрывать дескриптор принтера, связанный с параметром hPrinter .

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	prcomoem.h (включая Prcomoem.h)

См. также раздел

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter