Метод IPrintOemUI::GetInfo (prcomoem.h)

Метод подключаемого модуля пользовательского IPrintOemUI::GetInfo интерфейса возвращает идентификационные сведения.

Синтаксис

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Параметры

dwMode

Содержит одну из следующих целочисленных констант, предоставляемых вызывающим.

OEMGI_GETREQUESTEDHELPERINTERFACES

Метод должен записать значение битового флага OEMPUBLISH_IPRINTCOREHELPER в буфер pBuffer , если метод IPrintOemUI::P ublishDriverInterface должен быть вызван с параметром pIUnknown , указывающим на объект, реализующий интерфейс IPrintCoreHelperPS или интерфейс IPrintCoreHelperUni.

OEMGI_GETSIGNATURE

Метод должен возвращать уникальную четырехбайтовую идентификационную подпись. Подключаемый модуль также должен поместить эту сигнатуру в структуры OPTITEM, как описано в описании элемента pOEMOptItems структуры OEMCUIPPARAM.

OEMGI_GETVERSION

Метод должен возвращать номер версии подключаемого модуля пользовательского интерфейса в виде DWORD. Формат версии определяется разработчиком.

pBuffer

Предоставленный вызывающим объектом указатель на память, выделенную для получения сведений, заданных dwMode.

cbSize

Размер буфера, на который указывает pBuffer, предоставленный вызывающим объектом.

pcbNeeded

Предоставленный вызывающим объектом указатель на расположение для получения количества байтов, записанных в буфер, на который указывает pBuffer.

Возвращаемое значение

Метод должен возвращать одно из следующих значений.

Код возврата Описание
S_OK
Операция успешно выполнена.
E_FAIL
Операция не удалась.
E_NOTIMPL
Метод не реализован.

Комментарии

Подключаемые модули пользовательского интерфейса необходимы для реализации IPrintOemUI::GetInfo метода , который вызывается сразу после загрузки подключаемого модуля. Метод должен возвращать указанные сведения, записывая их на адрес, указанный pBuffer , и записывая размер возвращаемой информации в байтах в расположение, указанное pcbNeededed.

Если pBuffer имеет значение NULL, метод должен просто использовать pcbNeeded для возврата количества байтов, необходимых для хранения указанной информации.

Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в статье Настройка драйверов принтеров Майкрософт.

Требования

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

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

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo