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 MOF (Managed Object Format). 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 [in]

Valeur qui spécifie une commande de contrôle pour un service. Par exemple, une commande de contrôle est une commande « pause » ou « continuer ». La valeur peut être un code prédéfini, ou une valeur et une action que le service définit. Voici les codes de contrôle prédéfinis :

SERVICE_CONTROL_CONTINUE

Avertit un service suspendu de reprendre.

SERVICE_CONTROL_INTERROGATE

Notifie un service pour qu’il signale les informations de status actuelles au gestionnaire de contrôle de service.

SERVICE_CONTROL_NETBINDADD

Avertit un service réseau qu’il existe un nouveau composant pour la liaison.

SERVICE_CONTROL_NETBINDDISABLE

Avertit un service réseau qu’une de ses liaisons est désactivée.

SERVICE_CONTROL_NETBINDENABLE

Avertit un service réseau qu’une liaison désactivée est activée.

SERVICE_CONTROL_NETBINDREMOVE

Avertit un service réseau qu’un composant de liaison a été supprimé.

SERVICE_CONTROL_PARAMCHANGE

Avertit un service que ses paramètres de démarrage sont modifiés.

SERVICE_CONTROL_PAUSE

Avertit un service qu’il doit suspendre.

SERVICE_CONTROL_STOP

Avertit un service de s’arrêter.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou une autre valeur 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. State property) est égal à 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 de 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 de 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 ce service s’appuie est supprimée du système.

Échec des dépendances de 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é à partir du système.

Échec de l’ouverture de session au 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 du doublon d’état

19

Un service est en cours d'exécution sous le même nom.

Nom d’é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é transmis au service.

Compte de service 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.

Service d’état existant

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	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes du système d’exploitation

Win32_BaseService