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

Artikel
02/26/2024

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)

Freigeben über