Fonction DeleteService (winsvc.h)

Article
08/27/2023

Marque le service spécifié pour suppression de la base de données du gestionnaire de contrôle de service.

Syntaxe

BOOL DeleteService(
  [in] SC_HANDLE hService
);

Paramètres

[in] hService

Handle du service. Ce handle est retourné par la fonction OpenService ou CreateService , et il doit disposer du droit d’accès DELETE. Pour plus d’informations, consultez Sécurité des services et droits d’accès.

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.

Les codes d’erreur suivants peuvent être définis par le gestionnaire de contrôle de service. D’autres peuvent être définies par les fonctions de Registre appelées par le gestionnaire de contrôle de service.

Code de retour	Description
ERROR_ACCESS_DENIED	Le handle n’a pas le droit d’accès DELETE.
ERROR_INVALID_HANDLE	Le handle spécifié n’est pas valide.
ERROR_SERVICE_MARKED_FOR_DELETE	Le service spécifié a déjà été marqué pour suppression.

Remarques

La fonction DeleteService marque un service à supprimer de la base de données du gestionnaire de contrôle de service. L’entrée de base de données n’est pas supprimée tant que tous les handles ouverts du service n’ont pas été fermés par des appels à la fonction CloseServiceHandle et que le service n’est pas en cours d’exécution. Un service en cours d’exécution est arrêté par un appel à la fonction ControlService avec le code de contrôle SERVICE_CONTROL_STOP. Si le service ne peut pas être arrêté, l’entrée de base de données est supprimée lors du redémarrage du système.

Le gestionnaire de contrôle de service supprime le service en supprimant la clé de service et ses sous-clés du Registre.

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