Метод 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) |