CloseServiceHandle-Funktion (winsvc.h)

Artikel
03/09/2024

Schließt ein Handle für einen Dienststeuerungs-Manager oder ein Dienstobjekt.

Syntax

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

Parameter

[in] hSCObject

Ein Handle für das Dienststeuerungs-Manager-Objekt oder das zu schließende Dienstobjekt. Handles für Dienststeuerungs-Manager-Objekte werden von der OpenSCManager-Funktion zurückgegeben, und Handles für Dienstobjekte werden entweder von der OpenService - oder createService-Funktion zurückgegeben.

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.

Der folgende Fehlercode kann vom Dienststeuerungs-Manager festgelegt werden. Andere Fehlercodes können von Registrierungsfunktionen festgelegt werden, die vom Dienststeuerungs-Manager aufgerufen werden.

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Das angegebene Handle ist ungültig.

Hinweise

Die CloseServiceHandle-Funktion zerstört nicht das Dienststeuerungs-Manager-Objekt, auf das durch das Handle verwiesen wird. Ein Dienststeuerungs-Manager-Objekt kann nicht zerstört werden. Ein Dienstobjekt kann durch Aufrufen der DeleteService-Funktion zerstört werden.

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