Метод IPrintOemUI2::QueryJobAttributes (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemUI2::QueryJobAttributes позволяет подключаемый модуль пользовательского интерфейса после вызова DrvQueryJobAttributes DDI основного драйвера. Подключаемый модуль может перезаписать значения, которые основной драйвер помещается в буфер вывода lpAttributeInfo.

Синтаксис

HRESULT QueryJobAttributes(
  HANDLE   hPrinter,
  PDEVMODE pDevmode,
  DWORD    dwLevel,
  LPBYTE   lpAttributeInfo
);

Параметры

hPrinter

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

pDevmode

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

dwLevel

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

Ценность	Структура, на которую указывает lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Обратите внимание, что если этот метод изменяет любой объект dwDrvXxx член структуры ATTRIBUTE_INFO_N, средство spooler предполагает, что подключаемый модуль может поддерживать поведение, представленное этим элементом.

lpAttributeInfo

Указатель на расположение памяти, которое получает адрес структуры типа, определяемого dwLevel.

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

Если подключаемый модуль пользовательского интерфейса поддерживает этот метод и метод выполнен успешно, он должен вернуть S_OK. Это приводит к тому, что основной драйвер возвращает TRUE для DrvQueryJobAttributes DDI. Если подключаемый модуль пользовательского интерфейса поддерживает этот метод, но метод завершился ошибкой, он должен вернуть E_FAIL. Это приводит к тому, что основной драйвер возвращает FALSE для DDI DrvQueryJobAttributes. Если подключаемый модуль пользовательского интерфейса не поддерживает этот метод, он должен возвращать E_NOTIMPL.

Замечания

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

Дополнительные сведения см. DrvQueryJobAttributes.