Freigeben über


DeleteService-Funktion (winsvc.h)

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

Weitere Informationen

CloseServiceHandle

ControlService

CreateService

Openservice

Dienstfunktionen

Dienstinstallation, -entfernung und -enumeration