Метод 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 (описанной в документации по пакету SDK для Microsoft Windows), но она не несет ответственности за освобождение этой памяти.
метод IPrintOemPrintTicketProvider::GetSupportedVersions можно вызвать до вызова метода IPrintOemPrintTicketProvider::BindPrinter. В результате поставщик подключаемых модулей OEM не должен закрывать дескриптор принтера, связанный с параметром hPrinter.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | prcomoem.h (include Prcomoem.h) |