DrvUpgradePrinter-Funktion (winddiui.h)

  • Artikel

Die DrvUpgradePrinter-Funktion einer Druckerschnittstellen-DLL wird verwendet, um die Registrierungseinstellungen eines Druckers zu aktualisieren, wenn einem System eine neue Version des Treibers hinzugefügt wird.

Syntax

BOOL DrvUpgradePrinter(
                 DWORD  Level,
  [in, optional] LPBYTE pDriverUpgradeInfo
);

Parameter

Level

Vom Aufrufer bereitgestellter Wert, der den Typ der Struktur angibt, auf die pDriverUpgradeInfo verweist, wie in der folgenden Tabelle angegeben.

Ebenenwert Struktur, auf die von pDriverUpgradeInfo verwiesen wird
1 DRIVER_UPGRADE_INFO_1
2 DRIVER_UPGRADE_INFO_2

[in, optional] pDriverUpgradeInfo

Vom Aufrufer bereitgestellter Zeiger auf eine Struktur, deren Typ von dwLevel identifiziert wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte SetLastError aufgerufen werden, um einen Fehlercode festzulegen und FALSE zurückzugeben.

Hinweise

Eine Druckerschnittstellen-DLL kann optional eine DrvUpgradePrinter-Funktion bereitstellen. Wenn dies der Fall ist, ruft der Spooler es für jeden Drucker auf, wenn der Druckertreiber auf das System kopiert wird. Dies tritt auf, wenn ein System von einer Betriebssystemversion auf die nächste aktualisiert wird oder wenn eine Anwendung einen Druckertreiber aktualisiert, indem die Win32 AddPrinterDriver-Funktion aufgerufen wird.

Häufig erfordert eine neue Treiberversion Registrierungseinstellungen, die sich von denen der alten Version unterscheiden. Der Zweck der DrvUpgradePrinter-Funktion besteht darin, die Registrierung so zu aktualisieren, dass sie mit dem Treiber kompatibel ist. Weitere Informationen zum Speichern von Druckerinformationen in der Registrierung finden Sie unter DrvPrinterEvent.

Wenn der Spooler Für Windows 2000 und höher DrvUpgradePrinter aufruft, stellt er einen DRIVER_UPGRADE_INFO_2 Strukturzeiger für pDriverUpgradeInfo bereit. Wenn die Funktion FALSE zurückgibt, ruft der Spooler die Funktion erneut auf, wobei dieses Mal ein DRIVER_UPGRADE_INFO_1 Strukturzeiger angegeben wird. Wenn dieser Aufruf FALSE zurückgibt, schreibt der Spooler einen Eintrag in das Ereignisprotokoll.

Für Windows NT 4.0 und früher stellt der Spooler beim Aufrufen von DrvUpgradePrinter einen DRIVER_UPGRADE_INFO_1 Strukturzeiger für pDriverUpgradeInfo bereit. Wenn die Funktion FALSE zurückgibt, schreibt der Spooler einen Eintrag in das Ereignisprotokoll.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddiui.h (include Winddiui.h)

Weitere Informationen

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent