DeleteService-Funktion (winsvc.h)

Artikel
08/27/2023

Markiert den angegebenen Dienst zum Löschen aus der Dienststeuerungs-Manager-Datenbank.

Syntax

BOOL DeleteService(
  [in] SC_HANDLE hService
);

Parameter

[in] hService

Ein Handle für den Dienst. Dieses Handle wird von der OpenService - oder CreateService-Funktion zurückgegeben und muss über das DELETE-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Dienstsicherheit und Zugriffsrechte.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Die folgenden Fehlercodes können vom Dienststeuerungs-Manager festgelegt werden. Andere können von den Registrierungsfunktionen festgelegt werden, die vom Dienststeuerungs-Manager aufgerufen werden.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Das Handle verfügt nicht über das DELETE-Zugriffsrecht.
ERROR_INVALID_HANDLE	Das angegebene Handle ist ungültig.
ERROR_SERVICE_MARKED_FOR_DELETE	Der angegebene Dienst wurde bereits zum Löschen markiert.

Hinweise

Die DeleteService-Funktion markiert einen Dienst zum Löschen aus der Dienststeuerungs-Manager-Datenbank. Der Datenbankeintrag wird erst entfernt, wenn alle geöffneten Handles für den Dienst durch Aufrufe der CloseServiceHandle-Funktion geschlossen wurden und der Dienst nicht ausgeführt wird. Ein ausgeführter Dienst wird durch einen Aufruf der ControlService-Funktion mit dem SERVICE_CONTROL_STOP-Steuerelementcode beendet. Wenn der Dienst nicht beendet werden kann, wird der Datenbankeintrag entfernt, wenn das System neu gestartet wird.

Der Dienststeuerungs-Manager löscht den Dienst, indem er den Dienstschlüssel und seine Unterschlüssel aus der Registrierung löscht.

Beispiele

Ein Beispiel finden Sie unter Löschen eines Diensts.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsvc.h (windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll