RemovePrintDeviceObject-Funktion (winsplp.h)
Warnung
Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investition in Druckanbieter von Drittanbietern. Darüber hinaus können Drittanbieter unter Windows 8 und neueren Produkten, bei 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
Das handle to the device object to be removed. Dies sollte ein Geräteobjekt sein, das mit AddPrintDeviceObjecterstellt 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 z. B. HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) zurückgeben, wenn ein ungültiger Geräteobjekthandle zum Aufrufen der Funktion verwendet wurde. Und beachten Sie, dass das Geräteobjekt HANDLE unabhängig vom Rückgabewert ungültig wird, nachdem ein Aufruf von RemovePrintDeviceObject abgeschlossen wurde.
Bemerkungen
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, daher ist es nicht erforderlich, RemovePrintDeviceObject- für jedes Druckergerätobjekt aufzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | winsplp.h (include Winspool.h) |
| Library | WinSpool.lib |
| DLL- | WinSpool.drv |