Freigeben über


CloseServiceHandle-Funktion (winsvc.h)

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

Weitere Informationen

CreateService

DeleteService

OpenSCManager

Openservice

SCM-Handles

Dienstfunktionen