Méthode StartService de la classe Win32_SystemDriver

Article
06/12/2023

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

Voir aussi

Classes du système d’exploitation
Win32_SystemDriver

Share via