IPrintOemDriverUI::D rvUpdateUISetting-Methode (prcomoem.h)

  • Artikel

Die IPrintOemDriverUI::DrvUpdateUISetting -Methode wird von den Minitreibern Unidrv und Pscript5 bereitgestellt, sodass Benutzeroberflächen-Plug-Ins den Treiber über eine geänderte Benutzeroberflächenoption benachrichtigen können.

Syntax

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

Parameter

pci

Vom Aufrufer bereitgestellter Zeiger auf eine OEMUIOBJ-Struktur .

pOptItem

Vom Aufrufer bereitgestellter Zeiger auf eine OPTITEM-Struktur , die ein Optionselement für die Benutzeroberfläche beschreibt.

dwPreviousSelection

Wird nicht verwendet.

dwMode

Vom Aufrufer bereitgestellte ganzzahlige Konstante, die angibt, zu welcher Eigenschaftenblattseite das angegebene Optionselement gehört. Die folgenden Konstanten sind gültig.

Wert Definition
OEMCUIP_DOCPROP Das angegebene Optionselement gehört zur Seite Erweitert des Dokumenteigenschaftenblatts.
OEMCUIP_PRNPROP Das angegebene Optionselement gehört zur Seite Geräteeinstellungen des Druckereigenschaftenblatts.
 

Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL
 Fehler beim Vorgang.
E_NOTIMPL
 Die Methode ist nicht implementiert.

Hinweise

Wenn Sie ein Benutzeroberflächen-Plug-In bereitstellen, das die IPrintOemUI::D ocumentPropertySheets-Methode oder die IPrintOemUI::D evicePropertySheets-Methode implementiert, stellen Sie in der Regel auch eine _CPSUICALLBACK typisierte Rückruffunktion zur Verarbeitung von Benutzeränderungen bereit. Diese Rückruffunktion muss aufrufen IPrintOemDriverUI::DrvUpdateUISetting , um den Treiber darüber zu informieren, wenn der einer Benutzeroberflächeneinstellung zugeordnete Wert geändert wurde, wenn der Wert in der DEVMODEW-Struktur des Treibers (anstelle der privaten DEVMODEW-Member des Plug-Ins) oder in Registrierungsschlüsseln gespeichert wird.

Der für dwMode angegebene Wert sollte auf der Methode basieren, die die Rückruffunktion angegeben hat.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile prcomoem.h (include Prcomoem.h)