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
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

Classes du système d’exploitation

_BaseService Win32