Metodo IPrintOemDriverUI::D rvUpdateUISetting (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemDriverUI::DrvUpdateUISetting viene fornito dai minidriver Unidrv e Pscript5 in modo che i plug-in dell'interfaccia utente possano notificare al driver un'opzione dell'interfaccia utente modificata.

Sintassi

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

Parametri

pci

Puntatore fornito dal chiamante a una struttura OEMUIOBJ.

pOptItem

Puntatore fornito dal chiamante a una struttura OPTITEM che descrive un elemento di opzione dell'interfaccia utente.

dwPreviousSelection

Non utilizzato.

dwMode

Costante integer fornita dal chiamante che indica a quale pagina della finestra delle proprietà appartiene l'elemento di opzione fornito. Le costanti seguenti sono valide.

Valore	Definizione
OEMCUIP_DOCPROP	L'elemento di opzione fornito appartiene alla pagina Avanzate della finestra delle proprietà del documento.
OEMCUIP_PRNPROP	L'elemento di opzione fornito appartiene alla pagina Impostazioni dispositivo della finestra delle proprietà della stampante.

Per altre informazioni, vedere la sezione Osservazioni seguente.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Osservazioni

Se si fornisce un plug-in dell'interfaccia utente che implementa il metodo IPrintOemUI::D ocumentPropertySheets o il metodo IPrintOemUI::D evicePropertySheets, in genere si fornisce anche una funzione di callback _CPSUICALLBACKtipizzata per gestire le modifiche dell'utente. Questa funzione di callback deve chiamare IPrintOemDriverUI::DrvUpdateUISetting per informare il driver quando il valore associato a un'impostazione dell'interfaccia utente è stato modificato, se il valore viene archiviato nella struttura DEVMODEW del driver ( anziché i membri DEVMODEW privati del plug-in ) o nelle chiavi del Registro di sistema.

Il valore specificato per dwMode deve essere basato sul metodo specificato dalla funzione di callback.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite