Win32_SystemDriver classe

  • Article

La classe WMIWin32_SystemDriver représente le pilote système d’un service de base.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Membres

La classe Win32_SystemDriver a les types de membres suivants :

Méthodes

La classe Win32_SystemDriver a ces méthodes.

Méthode Description
Changement Méthode de classe qui modifie un service.
ChangeStartMode Méthode de classe qui modifie le mode de démarrage d’un service.
Créer Méthode de classe qui crée un service.
Supprimer Méthode de classe qui supprime un service existant.
InterrogationService Méthode de classe qui demande au service de mettre à jour son état sur le gestionnaire de services.
PauseService Méthode de classe qui tente de placer le service dans l’état suspendu.
ResumeService Méthode de classe qui tente de placer le service dans l’état repris.
StartService Méthode de classe qui tente de placer le service dans son état de démarrage.
StopService Méthode de classe qui place le service à l’état arrêté.
UserControlService Méthode de classe qui tente d’envoyer un code de contrôle défini par l’utilisateur à un service.

 

Propriétés

La classe Win32_SystemDriver a ces propriétés.

AcceptPause

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE »), DisplayName (« Service accepte la pause »)

Le service peut être suspendu.

Cette propriété est héritée de Win32_BaseService.

AcceptStop

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP »), DisplayName (« Service accepte l’arrêt »)

Le service peut être arrêté.

Cette propriété est héritée de Win32_BaseService.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : CIM_Key, DisplayName (« Nom de classe »)

Nom de la première classe concrète à apparaître dans la chaîne d’héritage utilisée lors de la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés de clé de la classe, cette propriété permet à toutes les instances de cette classe et à ses sous-classes d’être identifiées de manière unique.

Cette propriété est héritée de CIM_Service.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

DesktopInteract

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS »), DisplayName (« Interagit avec le bureau »)

Ce service peut créer ou communiquer avec des fenêtres sur le bureau.

Cette propriété est héritée de Win32_BaseService.

DisplayName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|lpDisplayName »), DisplayName (« Nom d’affichage »)

Nom complet du service. Cette chaîne a une longueur maximale de 256 caractères. Le nom est conservé à la casse dans le Gestionnaire de contrôle des services. Les comparaisons DisplayName ne respectent toujours pas la casse.

Contraintes : accepte la même valeur que la propriété Name .

Exemple : « Atdisk »

Cette propriété est héritée de Win32_BaseService.

ErrorControl

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|dwErrorControl »), DisplayName (« Gravité de l’échec de démarrage »)

Gravité de l’erreur si ce service ne parvient pas à démarrer au démarrage. Cette valeur indique l’action effectuée par le programme de démarrage en cas d’échec. Toutes les erreurs sont journalisées par le système informatique.

Cette propriété est héritée de Win32_BaseService.

Ignorer (« Ignorer »)

L'utilisateur n'est pas notifié.

Normal (« Normal »)

L'utilisateur est notifié.

Sévère (« Sévère »)

Le système est redémarré avec la dernière bonne configuration connue.

Critique (« Critique »)

Le système tente de redémarrer avec une bonne configuration.

Inconnu (« Inconnu »)

La cause de l’échec est inconnue.

ExitCode

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwWin32ExitCode »), DisplayName (« Code de sortie »)

Code d’erreur Windows définissant les problèmes rencontrés lors du démarrage ou de l’arrêt du service. Cette propriété a pour valeur ERROR_SERVICE_SPECIFIC_ERROR (1066) quand l’erreur est unique pour le service représenté par cette classe, et les informations sur l’erreur sont disponibles dans la propriété ServiceSpecificExitCode . Le service définit cette valeur sur NO_ERROR lors de l’exécution, puis à nouveau lors de l’arrêt normal.

Cette propriété est héritée de Win32_BaseService.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

L’objet a été installé. Cette propriété n’a pas besoin d’une valeur pour indiquer que l’objet est installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Clé

Identificateur unique du service qui fournit une indication de la fonctionnalité gérée. Cette fonctionnalité est décrite plus en détail dans la propriété Description de l’objet.

Cette propriété est héritée de CIM_Service.

PathName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|lpBinaryPathName »), DisplayName (« Nom du chemin de fichier »)

Chemin d’accès complet au fichier binaire de service qui implémente le service.

Exemple : « \SystemRoot\System32\drivers\afd.sys »

Cette propriété est héritée de Win32_BaseService.

ServiceSpecificExitCode

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwServiceSpecificExitCode »), DisplayName (« Code de sortie spécifique au serveur »)

Code d’erreur spécifique au service pour les erreurs qui se produisent pendant le démarrage ou l’arrêt du service. Les codes de sortie sont définis par le service représenté par cette classe. Cette valeur est définie uniquement lorsque la valeur de la propriété ExitCode est ERROR_SERVICE_SPECIFIC_ERROR (1066).

Cette propriété est héritée de Win32_BaseService.

Servicetype

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|dwServiceType »), DisplayName (« Type de service »)

Type de service fourni aux processus appelants.

Cette propriété est héritée de Win32_BaseService.

Les valeurs sont :

Pilote de noyau (« pilote de noyau »)

Pilote de système de fichiers (« pilote de système de fichiers »)

Adaptateur (« Adaptateur »)

Recognizer Driver (« Recognizer Driver »)

Propre processus (« propre processus »)

Processus de partage (« processus de partage »)

Processus interactif (« processus interactif »)

Get Started with Custom Speech Service (Prise en main de Custom Speech Service)

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Démarré »)

Le service a été démarré.

Cette propriété est héritée de CIM_Service.

StartMode

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Mode Démarrer »)

Mode de démarrage du pilote système.

Cette propriété est héritée de Win32_BaseService.

Démarrage (« Démarrage »)

Pilote de périphérique démarré par le chargeur du système d’exploitation (valide uniquement 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.

Auto (« Auto »)

Le service doit être démarré automatiquement par le gestionnaire de contrôle de service pendant le démarrage du système.

Manuel (« 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é.

StartName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|lpServiceStartName »), DisplayName (« Nom du compte de départ »)

Nom du compte sous lequel le service s’exécute. Selon le type de service, le nom du compte peut se présenter sous la forme DomainName\Username. Le processus de service est journalisé à l’aide de l’un de ces deux formulaires lorsqu’il s’exécute. Si le compte appartient au domaine intégré, .\Username peut être spécifié. Si null est spécifié, le service est connecté en tant que compte LocalSystem. Pour les pilotes au niveau du noyau ou du système, StartName contient le nom de l’objet du pilote (c’est-à-dire, \FileSystem\Rdr ou \Driver\Xns) que le système d’entrée et de sortie (E/S) utilise pour charger le pilote de périphérique. En outre, si null est spécifié, le pilote s’exécute avec un nom d’objet par défaut créé par le système d’E/S en fonction du nom du service.

Exemple : « DWDOM\Administration »

Cette propriété est héritée de Win32_BaseService.

State

Type de données : chaîne

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwCurrentState « ), DisplayName (« State »)

État actuel du service de base.

Cette propriété est héritée de Win32_BaseService.

Les valeurs sont :

Arrêté (« Arrêté »)

Démarrer en attente (« Démarrer en attente »)

Arrêter en attente (« Arrêter en attente »)

Exécution (« En cours d’exécution »)

Continuer en attente (« Continuer en attente »)

Suspendre en attente (« Suspendre en attente »)

Suspendu (« Suspendu »)

Inconnu (« Inconnu »)

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels sont les suivants : « OK », « Détérioré » et « Échec antérieur » (un élément, tel qu’un disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non opératoires sont les suivants : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer pendant miroir redimensionnement d’un disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_System. CreationClassName « ), CIM_Key, DisplayName (« Nom de classe système »)

Nom du type du système qui héberge ce service.

Cette propriété est héritée de CIM_Service.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_System. Nom »), CIM_Key, DisplayName (« Nom du système »)

Nom du système qui héberge ce service.

Cette propriété est héritée de CIM_Service.

TagId

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de service | QUERY_SERVICE_CONFIG|dwTagId « ), DisplayName (« Id de balise »)

Valeur d’étiquette unique pour ce service dans le groupe. La valeur 0 (zéro) indique que le service n’a pas reçu de balise. Une balise peut être utilisée pour commander le démarrage du service au sein d’un groupe de commandes de chargement en spécifiant un vecteur d’ordre de balise dans le registre situé à l’adresse suivante :

Cette propriété est héritée de Win32_BaseService.

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList.

Les balises sont évaluées uniquement pour les services de type de démarrage de pilote de noyau et de pilote de système de fichiers qui ont les modes Démarrage ou Démarrage du système.

Notes

La classe Win32_SystemDriver est dérivée de Win32_BaseService.

Exemples

L’exemple List System Drivers VBScript Affiche les pilotes système installés dans un fichier HTML.

L’exemple PowerShell suivant récupère un certain nombre de propriétés à partir des pilotes système en cours d’exécution sur un ordinateur.

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

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

Win32_BaseService

Classes du système d’exploitation