Fonction CloseServiceHandle (winsvc.h)

Article
03/04/2024

Ferme un handle à un gestionnaire de contrôle de service ou à un objet de service.

Syntaxe

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

Paramètres

[in] hSCObject

Handle de l’objet gestionnaire de contrôle de service ou de l’objet de service à fermer. Les handles aux objets du gestionnaire de contrôle de service sont retournés par la fonction OpenSCManager , et les handles aux objets de service sont retournés par la fonction OpenService ou CreateService .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Le code d’erreur suivant peut être défini par le gestionnaire de contrôle de service. D’autres codes d’erreur peuvent être définis par des fonctions de Registre appelées par le gestionnaire de contrôle de service.

Code de retour	Description
ERROR_INVALID_HANDLE	Le handle spécifié n’est pas valide.

Remarques

La fonction CloseServiceHandle ne détruit pas l’objet gestionnaire de contrôle de service auquel le handle fait référence. Un objet gestionnaire de contrôle de service ne peut pas être détruit. Un objet de service peut être détruit en appelant la fonction DeleteService .

Exemples

Pour obtenir un exemple, consultez Suppression d’un service.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsvc.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll