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

Weitere Informationen

AddPrintDeviceObject