Metodo IPrintCoreUI2::D rvUpdateUISetting (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintCoreUI2::DrvUpdateUISetting viene fornito dal driver Windows XP Pscript5 in modo che i plug-in dell'interfaccia utente Pscript5 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.
OEMCUIP_PRNPROP	L'elemento di opzione fornito appartiene alla pagina Impostazioni dispositivo della finestra delle proprietà della stampante.

Valore restituito

Questo 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

Questo metodo viene ereditato dal interfaccia COM IPrintOemDriverUIe può essere chiamato solo dai plug-in dell'interfaccia utente Pscript5 di Windows XP che non sostituiscono completamente le pagine dell'interfaccia utente standard del driver principale, ed è supportato durante la IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets e le relative routine di callback del foglio delle proprietà. Quando questo metodo è supportato, ha lo stesso comportamento di IPrintOemDriverUI::D rvUpdateUISetting. Se non è supportato, questo metodo deve restituire E_NOTIMPL.