Edit

IPrintOemDriverUI::DrvUpdateUISetting method (prcomoem.h)

  • Article

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.

Syntax

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

Parameters

pci

Caller-supplied pointer to an OEMUIOBJ structure.

pOptItem

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

dwPreviousSelection

Not used.

dwMode

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
S_OK
 The operation succeeded.
E_FAIL
 The operation failed.
E_NOTIMPL
 The method is not implemented.

Remarks

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.

Requirements

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