UpdatePrintDeviceObject-Funktion (winsplp.h)
Warnung
Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investitionen in Druckdienstleister von Drittanbietern. Bei Windows 8 und neueren Produkten, bei denen das v4-Drucktreibermodell verfügbar ist, können Druckanbieter von Drittanbietern möglicherweise keine Warteschlangen erstellen oder verwalten, die v4-Drucktreiber verwenden.
Die UpdatePrintDeviceObject-Funktion aktualisiert die Eigenschaften eines Geräteobjekts, das sich in der Druckanbieterwarteschlange befindet.
Syntax
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
Parameter
[in] hPrinter
Das HANDLE für einen geöffneten Drucker. Dies sollte ein Handle sein, das von den Spoolerfunktionen AddPrinter oder OpenPrinter zurückgegeben wurde.
[in] hDeviceObject
Der HANDLE für das zu aktualisierende Geräteobjekt. Dies sollte ein Geräteobjekt sein, das mit AddPrintDeviceObject erstellt wurde.
Rückgabewert
Die UpdatePrintDeviceObject-Funktion gibt S_OK zurück, wenn die Eigenschaften des Geräteobjekts erfolgreich aktualisiert wurden. Andernfalls wird ein Fehler zurückgegeben.
Diese Funktion kann beispielsweise HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) zurückgeben, wenn der Funktionsaufruf mit einem ungültigen HANDLE erfolgt ist oder das Geräteobjekt entfernt wurde, bevor der Funktionsaufruf durchgeführt wurde.
Hinweise
Die PRINTER_INFO_2-Struktur ist ein gutes Beispiel für die Art von Eigenschaften, die UpdatePrintDeviceObject aktualisieren kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winsplp.h (winspool.h einschließen) |
| Bibliothek | WinSpool.lib |
| DLL | WinSpool.drv |