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

Статья
02/07/2025

Метод 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, как описано в описании элемента OEMCUIPPARAM структуры pOEMOptItems.

OEMGI_GETVERSION

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

pBuffer

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

cbSize

Указанный вызывающим размер буфера, на который указывает pBuffer.

pcbNeeded

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

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

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

Возвращаемый код	Описание
S_OK	Операция завершилась успешно.
E_FAIL	Сбой операции.
E_NOTIMPL	Метод не реализован.

Замечания

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

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

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

См. также

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo

Поделиться через