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

La méthode de classe WMI ChangeStartMode modifie le mode de démarrage d' un _ service Win32.

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 ChangeStartMode(
  [in] string StartMode = Auto Start
);

Paramètres

StartMode [ dans]

mode de démarrage du service de base Windows.

Démarrage du 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ébut de la demande (« manuel »)

Service qui doit être démarré par le gestionnaire de contrôle des services 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 d’autres codes d’erreur, consultez constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir les valeurs de 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’a 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.**** La propriété State) est égale à 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 lors du démarrage du service.

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

Échec de la dépendance du 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 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

Ce service est en cours de suppression 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 lorsqu’il démarre.

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é transmis 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

Exemples

Le startMode de modification suivant d’un exemple PowerShell de service, extrait de la Galerie TechNet, 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" }

Configuration requise

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

_Service Win32

Tâches WMI : services