DrvUpgradePrinter-Funktion (winddiui.h)
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) |