IPrintOemUI::UpgradePrinter-Methode (prcomoem.h)

  • Artikel

Die IPrintOemUI::UpgradePrinter -Methode ermöglicht einem Benutzeroberflächen-Plug-In das Upgrade von Geräteoptionswerten, die in der Registrierung gespeichert sind.

Syntax

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Parameter

dwLevel

Vom Aufrufer bereitgestellte Versionsnummer der Struktur, auf die von pDriverUpgradeInfo verwiesen wird. Der aktuelle gültige Wert ist 1.

pDriverUpgradeInfo

Vom Aufrufer bereitgestellter Zeiger auf eine DRIVER_UPGRADE_INFO_1-Struktur .

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 für einen der Druckertreiber von Microsoft bereitstellen und das Benutzeroberflächen-Plug-In Geräteoptionswerte in der Registrierung speichert, sollte es die IPrintOemUI::UpgradePrinter -Methode zum Aktualisieren dieser Werte implementieren.

Die Methode eines IPrintOemUI::UpgradePrinter Benutzeroberflächen-Plug-Ins führt dieselben Arten von Vorgängen wie die DrvUpgradePrinter-Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Wenn die DrvUpgradePrinter-Funktion des Treibers aufgerufen wird, aktualisiert sie ihre eigenen Registrierungswerte und ruft dann die -Methode auf IPrintOemUI::UpgradePrinter .

Wenn IPrintOemUI::UpgradePrinter Methoden von mehreren Benutzeroberflächen-Plug-Ins exportiert werden, werden die Methoden in der Reihenfolge aufgerufen, in der die Plug-Ins für die Installation angegeben werden.

Weitere Informationen zum Erstellen und Installieren von Benutzeroberflächen-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.

Anforderungen

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