Partager via


Fonction DeleteService (winsvc.h)

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

Voir aussi

CloseServiceHandle

ControlService

CreateService

OpenService

Fonctions de service

Installation, suppression et énumération du service