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

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

Синтаксис

HRESULT DevQueryPrintEx(
  POEMUIOBJ           poemuiobj,
  PDEVQUERYPRINT_INFO pDQPInfo,
  PDEVMODE            pPublicDM,
  PVOID               pOEMDM
);

Параметры

poemuiobj

Предоставленный вызывающим объектом указатель на структуру OEMUIOBJ .

pDQPInfo

Указатель на структуру DEVQUERYPRINT_INFO , предоставленный вызывающим абонентом.

pPublicDM

Предоставленный вызывающим абонентом указатель на проверенную структуру DEVMODEW .

pOEMDM

Предоставленный вызывающим абонентом указатель на частные элементы структуры DEVMODEW подключаемого модуля пользовательского интерфейса.

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

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

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

Комментарии

Метод подключаемого модуля IPrintOemUI::DevQueryPrintEx пользовательского интерфейса выполняет те же типы операций, что и функция DevQueryPrintEx , экспортируемая библиотеками DLL интерфейса принтера в пользовательском режиме. Этот метод можно использовать для улучшения функциональных возможностей, предоставляемых функцией DevQueryPrintEx . Как и функция DevQueryPrintEx , метод отвечает за определение возможности печати задания печати, IPrintOemUI::DevQueryPrintEx описанного в предоставленной структуре DEVMODEW.

При вызове функции DevQueryPrintEx драйвера она проверяет структуру DEVMODEW вместе с выбранными параметрами принтера, чтобы определить, доступно ли задание для печати. Если это не так, функция возвращает значение FALSE. Если задание является печатаемым, функция вызывает метод в каждом подключаемом модуле пользовательского IPrintOemUI::DevQueryPrintEx интерфейса, связанном с драйвером. Если все IPrintOemUI::DevQueryPrintEx методы возвращают S_OK, то DevQueryPrintEx возвращает значение TRUE. Таким образом, задание невозможно распечатать, если только функция DevQueryPrintEx и все IPrintOemUI::DevQueryPrintEx методы не объявят его как печатаемое.

Если IPrintOemUI::DevQueryPrintEx методы экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указаны подключаемые модули для установки.

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

Требования

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

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

DevQueryPrintEx