Méthode ChangeStartMode de la classe Win32_Service (fournisseurs WMI CIMWin32)

La méthode de classe WMIChangeStartMode modifie le mode de démarrage d’un Win32_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 ChangeStartMode(
  [in] string StartMode = Auto Start
);

Paramètres

StartMode [in]

Mode de démarrage du service de base Windows.

Démarrage (« Démarrage »)

Pilote de périphérique démarré par le chargeur du système d’exploitation. Cette valeur est uniquement valide pour les services de pilote.

Système (« Système »)

Pilote de périphérique démarré par le processus d’initialisation du système d’exploitation. Cette valeur est uniquement valide pour les services de pilote.

Démarrage automatique (« automatique »)

Le service doit être démarré automatiquement par le Gestionnaire de contrôle des services lors du démarrage du système.

Démarrage de la demande (« manuel »)

Service à démarrer par le gestionnaire de contrôle de service lorsqu’un processus appelle la méthode StartService .

Désactivé (« Désactivé »)

Service qui ne peut plus être démarré.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante ou toute autre valeur pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Success

0

La demande a été acceptée.

Non pris en charge

1

La demande n'est pas prise en charge.

Accès refusé

2

L’utilisateur n’avait pas l’accès nécessaire.

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

Le service n'a pas été démarré.

Délai d’expiration de la demande de service

7

Le service n'a pas répondu à la demande de démarrage en temps voulu.

Échec inconnu

8

Échec inconnu au démarrage du service.

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 a été supprimée du système.

Échec des dépendances de service

13

Le service n'a pas pu trouver le service nécessaire à partir d'un service dépendant.

Service désactivé

14

Le service a été désactivé 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

Ce service est supprimé du système.

Service Sans thread

17

Le service n’a pas de thread d’exécution.

Dépendance circulaire d’état

18

Le service a des dépendances circulaires au démarrage.

Nom du doublon d’état

19

Un service s’exécute sous le même nom.

Nom d’état non valide

20

Le nom du service comporte 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 non valide

22

Le compte sous lequel ce service s’exécute n’est pas valide ou n’a pas les 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

Exemples

L’exemple Change StartMode suivant d’un exemple PowerShell de service , extrait de TechNet Gallery, modifie le mode de démarrage d’un service.

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

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_Service

Tâches WMI : Services