DrvUpgradePrinter-Funktion (winddiui.h)
Die DrvUpgradePrinter--Funktion einer Druckerschnittstelle wird zum Aktualisieren der Registrierungseinstellungen eines Druckers verwendet, wenn einer neuen Version des Treibers ein System 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 pDriverUpgradeInfoverweist, wie in der folgenden Tabelle angegeben.
| wert Level | Struktur von pDriverUpgradeInfo- |
|---|---|
| 1 | DRIVER_UPGRADE_INFO_1 |
| 2 | DRIVER_UPGRADE_INFO_2 |
[in, optional] pDriverUpgradeInfo
Vom Aufrufer bereitgestellter Zeiger auf eine Struktur, deren Typ durch dwLevelidentifiziert wird.
Rückgabewert
Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE-zurückgeben; andernfalls sollte SetLastError aufgerufen werden, um einen Fehlercode festzulegen und FALSEzurückzugeben.
Bemerkungen
Eine Druckerschnittstellen-DLL- kann optional eine DrvUpgradePrinter--Funktion bereitstellen. Wenn dies der Fall ist, ruft der Spooler ihn für jeden Drucker auf, wenn der Druckertreiber in 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 durch Aufrufen der Win32-AddPrinterDriver--Funktion aktualisiert.
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.
Bei Windows 2000 und höher, wenn der Spooler DrvUpgradePrinter-aufruft, stellt es einen DRIVER_UPGRADE_INFO_2 Strukturzeiger für pDriverUpgradeInfo. Wenn die Funktion FALSEzurückgibt, ruft der Spooler die Funktion erneut auf, dieses Mal wird ein DRIVER_UPGRADE_INFO_1 Strukturzeiger angegeben. Wenn dieser Aufruf FALSE-zurückgibt, schreibt der Spooler einen Eintrag im Ereignisprotokoll.
Bei Windows NT 4.0 und vorherigem Aufruf des Spoolers DrvUpgradePrinter-wird ein DRIVER_UPGRADE_INFO_1 Strukturzeiger für pDriverUpgradeInfo. Wenn die Funktion FALSE-zurückgibt, schreibt der Spooler einen Eintrag im Ereignisprotokoll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | winddiui.h (include Winddiui.h) |