Metodo IPrintOemDriverUI::D rvUpdateUISetting (prcomoem.h)

Articolo
08/07/2023

Il IPrintOemDriverUI::DrvUpdateUISetting metodo 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 usato.

dwMode

Costante integer fornita dal chiamante che indica la pagina del foglio delle proprietà a cui appartiene l'elemento dell'opzione fornito. Le costanti seguenti sono valide.

valore	Definizione
OEMCUIP_DOCPROP	L'elemento dell'opzione fornito appartiene alla pagina Avanzate del foglio delle proprietà del documento.
OEMCUIP_PRNPROP	L'elemento dell'opzione fornito appartiene alla pagina Impostazioni dispositivo del foglio delle proprietà della stampante.

Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

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

Commenti

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 una funzione callback _CPSUICALLBACK tipizzata per gestire le modifiche 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 su quale metodo è stata specificata la funzione di callback.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	prcomoem.h (include Prcomoem.h)

Share via