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 |
|
| DLL |
|