RemovePrintDeviceObject-Funktion (winsplp.h)
Warnung
Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investitionen in Druckanbieter von Drittanbietern. Darüber hinaus können Druckanbieter von Drittanbietern in Windows 8 und neueren Produkten, in denen das v4-Drucktreibermodell verfügbar ist, keine Warteschlangen erstellen oder verwalten, die v4-Drucktreiber verwenden.
Die RemovePrintDeviceObject-Funktion entfernt ein Geräteobjekt aus einer Druckanbieterwarteschlange.
Syntax
HRESULT RemovePrintDeviceObject(
[in] HANDLE hDeviceObject
);
Parameter
[in] hDeviceObject
Der HANDLE für das zu entfernende Geräteobjekt. Hierbei sollte es sich um ein Geräteobjekt handeln, das mit AddPrintDeviceObject erstellt wurde.
Rückgabewert
Die RemovePrintDeviceObject-Funktion gibt S_OK zurück, wenn das Geräteobjekt erfolgreich entfernt wurde. Andernfalls wird ein Fehler zurückgegeben.
Diese Funktion kann beispielsweise HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) zurückgeben, wenn zum Aufrufen der Funktion ein ungültiges Geräteobjekthandle verwendet wurde. Beachten Sie außerdem, dass unabhängig vom Rückgabewert das Geräteobjekt HANDLE ungültig wird, nachdem ein Aufruf von RemovePrintDeviceObject abgeschlossen wurde.
Hinweise
Rufen Sie RemovePrintDeviceObject auf, um das Geräteobjekt für einen gelöschten Drucker zu entfernen. Wenn die Spoolerdienste beendet werden, werden alle Geräteobjekte automatisch gelöscht, sodass es nicht erforderlich ist , RemovePrintDeviceObject für jedes Druckergeräteobjekt aufzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winsplp.h (einschließlich Winspool.h) |
| Bibliothek | WinSpool.lib |
| DLL | WinSpool.drv |