Метод IPrintOemDriverUI::D rvUpdateUISetting (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemDriverUI::DrvUpdateUISetting предоставляется мини-drivers Unidrv и Pscript5, чтобы подключаемые модули пользовательского интерфейса могли уведомлять драйвер измененного параметра пользовательского интерфейса.

Синтаксис

HRESULT DrvUpdateUISetting(
  PVOID pci,
  PVOID pOptItem,
  DWORD dwPreviousSelection,
  DWORD dwMode
);

Параметры

pci

Указатель на OEMUIOBJ.

pOptItem

Вызывающий указатель на структуру OPTITEM, описывающую элемент параметра пользовательского интерфейса.

dwPreviousSelection

Не используется.

dwMode

Вызываемая целочисленная константа, указывающая, к какой странице листа свойств принадлежит указанный элемент параметра. Допустимы следующие константы.

Ценность	Определение
OEMCUIP_DOCPROP	Указанный элемент параметра принадлежит странице "Дополнительно" листа свойств документа.
OEMCUIP_PRNPROP	Указанный элемент параметра принадлежит странице "Параметры устройства" на листе свойств принтера.

Дополнительные сведения см. в следующем разделе "Примечания".

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

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

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

Замечания

Если вы предоставляете подключаемый модуль пользовательского интерфейса, реализующий метод IPrintOemUI::D ocumentPropertySheet s или метод IPrintOemUI::D evicePropertySheets, вы также предоставляете функцию обратного вызова _CPSUICALLBACKтипа типа для обработки изменений пользователей. Эта функция обратного вызова должна вызывать IPrintOemDriverUI::DrvUpdateUISetting, чтобы сообщить драйверу, когда было изменено значение, связанное с параметром пользовательского интерфейса, если значение хранится в структуре драйвера DEVMODEW (вместо частных членов DEVMODEW подключаемого модуля) или в разделах реестра.

Значение, указанное для dwMode, должно быть основано на том, какой метод указал функцию обратного вызова.

Требования

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

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