Partager via


Fonction CloseServiceHandle (winsvc.h)

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

Voir aussi

CreateService

DeleteService

OpenSCManager

OpenService

SCM Handles

Fonctions de service