Método IPrintOemDriverUI::D rvUpdateUISetting (prcomoem.h)

  • Artículo

Los minidrivers Unidrv y Pscript5 proporcionan el IPrintOemDriverUI::DrvUpdateUISetting método para que los complementos de la interfaz de usuario puedan notificar al controlador una opción de interfaz de usuario modificada.

Sintaxis

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

Parámetros

pci

Puntero proporcionado por el autor de la llamada a una estructura OEMUIOBJ .

pOptItem

Puntero proporcionado por el autor de la llamada a una estructura OPTITEM que describe un elemento de opción de interfaz de usuario.

dwPreviousSelection

No se usa.

dwMode

Constante entero proporcionada por el autor de la llamada que indica a qué página de hoja de propiedades pertenece el elemento de opción proporcionado. Las siguientes constantes son válidas.

Value Definición
OEMCUIP_DOCPROP El elemento de opción proporcionado pertenece a la página Avanzadas de la hoja de propiedades del documento.
OEMCUIP_PRNPROP El elemento de opción proporcionado pertenece a la página Configuración del dispositivo de la hoja de propiedades de la impresora.
 

Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto Descripción
S_OK
 La operación se realizó correctamente.
E_FAIL
 Error en la operación.
E_NOTIMPL
 El método no está implementado.

Comentarios

Si proporciona un complemento de interfaz de usuario que implementa el método IPrintOemUI::D ocumentPropertySheets o el método IPrintOemUI::D evicePropertySheets , normalmente también proporciona una función de devolución de llamada con tipo _CPSUICALLBACK para controlar las modificaciones del usuario. Esta función de devolución de llamada debe llamar IPrintOemDriverUI::DrvUpdateUISetting a para informar al controlador cuando se ha modificado el valor asociado a una configuración de interfaz de usuario, si el valor se almacena en la estructura DEVMODEW del controlador (en lugar de los miembros PRIVADOS de DEVMODEW del complemento) o en las claves del Registro.

El valor especificado para dwMode debe basarse en qué método especificó la función de devolución de llamada.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado prcomoem.h (incluya Prcomoem.h)