Méthode StartService de la classe Win32_SystemDriver
La méthode StartService tente de placer le service géré par le pilote système dans son état de démarrage.
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 StartService();
Paramètres
Cette méthode n’a aucun paramètre.
Valeur retournée
Retourne l’une des valeurs suivantes.
-
0
-
La demande a été acceptée.
-
1
-
La demande n'est pas prise en charge.
-
2
-
L’utilisateur n’avait pas l’accès nécessaire.
-
3
-
Le service ne peut pas être arrêté car d'autres services en cours d'exécution en dépendent.
-
4
-
Le code de contrôle demandé n'est pas valide ou est inacceptable pour le service.
-
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.
-
6
-
Le service n'a pas été démarré.
-
7
-
Le service n'a pas répondu à la demande de démarrage en temps voulu.
-
8
-
Un échec inconnu s'est produit lors du démarrage du service.
-
9
-
Le chemin d’accès au répertoire du fichier exécutable de service est introuvable.
-
10
-
Le service est déjà en cours d'exécution.
-
11
-
La base de données pour ajouter un nouveau service est verrouillée.
-
12
-
Une dépendance sur laquelle ce service s’appuie a été supprimée du système.
-
13
-
Le service n'a pas pu trouver le service nécessaire à partir d'un service dépendant.
-
14
-
Le service a été désactivé du système.
-
15
-
Le service ne dispose pas de l'authentification correcte pour être exécuté sur le système.
-
16
-
Ce service est supprimé du système.
-
17
-
Il n'y a pas de thread d'exécution pour le service.
-
18
-
Le démarrage du service donne lieu à des dépendances circulaires.
-
19
-
Un service est en cours d'exécution sous le même nom.
-
20
-
Le nom du service contient des caractères non valides.
-
21
-
Des paramètres non valides ont été passés au service.
-
22
-
Le compte sous lequel ce service doit s’exécuter n’est pas valide ou n’a pas les autorisations nécessaires pour exécuter le service.
-
23
-
Le service existe dans la base de données des services disponibles dans le système.
-
24
-
Le service est actuellement mis en pause dans le système.
Exemples
Le code PowerShell suivant démarre le service « Microsoft USB Printer class ».
$usbPrintDriver = Get-WmiObject -query "SELECT * FROM Win32_SystemDriver WHERE Name = 'usbprint'"
$Return = $usbPrintDriver.StartService()
"Start Service Called. Return value is " + $return.ReturnValue + "."
"To figure out what this means, go look at the docs above this code snippet."
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 |
|