Méthode UserControlService de la _ classe Win32 BaseService
La méthode de classe WMI tente d’envoyer un code de contrôle défini par l’utilisateur à un service.
Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.
Syntaxe
uint32 UserControlService(
[in] uint8 ControlCode
);
Paramètres
-
ControlCode [ dans]
-
Valeur qui spécifie une commande de contrôle pour un service. Par exemple, une commande de contrôle est une commande « suspendre » ou « continuer ». La valeur peut être un code prédéfini, ou une valeur et une action que le service définit. Les codes de contrôle prédéfinis sont les suivants :
-
_le contrôle du service _ continue
-
Avertit un service suspendu de reprendre.
-
interrogation du contrôle des services _ _
-
Avertit un service qu’il doit signaler les informations d’état actuelles au gestionnaire de contrôle des services.
-
_NETBINDADD de contrôle de service _
-
Notifie un service réseau qu’il existe un nouveau composant pour la liaison.
-
_NETBINDDISABLE de contrôle de service _
-
Notifie un service réseau qu’une de ses liaisons est désactivée.
-
_NETBINDENABLE de contrôle de service _
-
Notifie un service réseau qu’une liaison désactivée est activée.
-
_NETBINDREMOVE de contrôle de service _
-
Notifie un service réseau qu’un composant pour la liaison a été supprimé.
-
_PARAMCHANGE de contrôle de service _
-
Avertit un service que ses paramètres de démarrage sont modifiés.
-
_suspension du contrôle de service _
-
Notifie un service de s’interrompre.
-
_arrêt du contrôle de service _
-
Notifie l’arrêt d’un service.
Valeur de retour
Retourne l’une des valeurs répertoriées dans la liste suivante, ou une valeur différente pour indiquer une erreur.
-
Success
-
0
La demande est acceptée.
-
Non pris en charge
-
1
La demande n'est pas prise en charge.
-
Accès refusé
-
2
L’utilisateur ne dispose pas des droits d’accès nécessaires.
-
Services dépendants en cours d’exécution
-
3
Le service ne peut pas être arrêté car d'autres services en cours d'exécution en dépendent.
-
Contrôle de service non valide
-
4
Le code de contrôle demandé n'est pas valide ou est inacceptable pour le service.
-
Le service ne peut pas accepter le contrôle
-
5
Le code de contrôle demandé ne peut pas être envoyé au service car l’état du service (Win32 _ BaseService.**** La propriété State) est égale à 0, 1 ou 2.
-
Service non actif
-
6
Ce service n'a pas démarré.
-
Délai d’expiration de la demande de service
-
7
Le service ne répond pas rapidement à la demande de démarrage.
-
Échec inconnu
-
8
Processus interactif.
-
Chemin introuvable
-
9
Le chemin d’accès au répertoire du fichier exécutable du service est introuvable.
-
Service déjà en cours d’exécution
-
10
Le service est déjà en cours d'exécution.
-
Base de données du service verrouillée
-
11
La base de données pour ajouter un nouveau service est verrouillée.
-
Dépendance de service supprimée
-
12
Une dépendance sur laquelle repose ce service est supprimée du système.
-
Échec de la dépendance du service
-
13
Le service ne trouve pas le service nécessaire à partir d’un service dépendant.
-
Service désactivé
-
14
Le service est désactivé du système.
-
Échec de l’ouverture de session du service
-
15
Le service ne dispose pas de l'authentification correcte pour être exécuté sur le système.
-
Service marqué pour suppression
-
16
Le service est en cours de suppression du système.
-
Service sans thread
-
17
Il n'y a pas de thread d'exécution pour le service.
-
Dépendance circulaire d’État
-
18
Le démarrage du service donne lieu à des dépendances circulaires.
-
Nom de l’État en double
-
19
Un service est en cours d'exécution sous le même nom.
-
Nom de l’état non valide
-
20
Le nom du service contient des caractères non valides.
-
Paramètre d’État non valide
-
21
Des paramètres non valides ont été passés au service.
-
Compte de service de l’état non valide
-
22
Le compte sous lequel ce service s’exécute n’est pas valide ou ne dispose pas des autorisations nécessaires pour exécuter le service.
-
Le service d’État existe
-
23
Le service existe dans la base de données des services disponibles dans le système.
-
Service déjà suspendu
-
24
Le service est actuellement mis en pause dans le système.
-
Autres
-
25 4294967295
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
\Cimv2 racine |
| MOF |
|
| DLL |
|