IPrintOemDriverUI::DrvUpdateUISetting method

The IPrintOemDriverUI::DrvUpdateUISetting method is provided by the Unidrv and Pscript5 minidrivers so that user interface plug-ins can notify the driver of a modified user interface option.


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



Caller-supplied pointer to an OEMUIOBJ structure.


Caller-supplied pointer to an OPTITEM structure describing a user interface option item.


Not used.


Caller-supplied integer constant indicating to which property sheet page the supplied option item belongs. The following constants are valid.

Value Definition
OEMCUIP_DOCPROP The supplied option item belongs to the Advanced page of the document property sheet.
OEMCUIP_PRNPROP The supplied option item belongs to the Device Settings page of the printer property sheet.

For more information, see the following Remarks section.

Return Value

The method must return one of the following values.

Return code Description
The operation succeeded.
The operation failed.
The method is not implemented.


If you are providing a user interface plug-in that implements the IPrintOemUI::DocumentPropertySheets method or the IPrintOemUI::DevicePropertySheets method, you typically also supply a _CPSUICALLBACK-typed callback function to handle user modifications. This callback function must call IPrintOemDriverUI::DrvUpdateUISetting to inform the driver when the value associated with a user interface setting has been modified, if the value is stored in the driver's DEVMODEW structure (instead of the plug-in's private DEVMODEW members ) or in registry keys.

The value specified for dwMode should be based on which method specified the callback function.


Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)