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

Статья
02/07/2025

Метод 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 (include Prcomoem.h)

См. также

DevQueryPrintEx

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