Метод 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.
Возвращаемое значение
Метод должен возвращать одно из следующих значений.
Код возврата | Описание |
---|---|
|
Операция успешно выполнена. |
|
Операция не удалась. |
|
Метод не реализован. |
Комментарии
Подключаемые модули пользовательского интерфейса необходимы для реализации IPrintOemUI::GetInfo
метода , который вызывается сразу после загрузки подключаемого модуля. Метод должен возвращать указанные сведения, записывая их на адрес, указанный pBuffer , и записывая размер возвращаемой информации в байтах в расположение, указанное pcbNeededed.
Если pBuffer имеет значение NULL, метод должен просто использовать pcbNeeded для возврата количества байтов, необходимых для хранения указанной информации.
Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в статье Настройка драйверов принтеров Майкрософт.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | prcomoem.h (включая Prcomoem.h) |