classe Win32_BaseService

Article
06/12/2023

La classe WMI abstraite Win32_BaseService représente des objets exécutables qui sont installés dans une base de données du Registre gérée par le Gestionnaire de contrôle de service. Le fichier exécutable associé à un service peut être démarré au démarrage par un programme de démarrage ou par le système. Il peut également être démarré à la demande par le Gestionnaire de contrôle des services. Tout service ou processus qui n’appartient pas à un utilisateur spécifique et qui fournit une interface à certaines fonctionnalités prises en charge par le système informatique, est un descendant (ou membre) de cette classe.

Exemple : le service client DHCP (Dynamic Host Configuration Protocol) sur un système informatique exécutant Windows Server.

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 sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  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_BaseService a les types de membres suivants :

Méthodes
Propriétés

Méthodes

La classe Win32_BaseService possède ces méthodes.

Méthode	Description
Changement	Modifie un service.
ChangeStartMode	Modifie le mode de démarrage d’un service.
Créer	Crée un nouveau service.
Supprimer	Supprime un service existant.
InterrogationService	Demande au service de mettre à jour son état sur le gestionnaire de services.
PauseService	Tente de placer le service dans l'état de pause.
ResumeService	Tente de placer le service dans l'état de reprise.
StartService	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	Tente d’envoyer un code de contrôle défini par l’utilisateur à un service.

Propriétés

La classe Win32_BaseService possède 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.

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

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 la classe »)

Nom de la première classe concrète à apparaître dans la chaîne d’héritage utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés clés de la classe, la propriété permet à toutes les instances de cette classe et de 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 (« Interactions avec le bureau »)

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

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 d’affichage du service. Cette chaîne a une longueur maximale de 256 caractères. Le nom est conservé selon la casse dans le Gestionnaire de contrôle de service. Les comparaisons de DisplayName ne respectent toujours pas la casse.

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

Exemple : « Atdisk »

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. Le service ne démarre pas. La 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.

Ignorer (« Ignorer »)

L'utilisateur n'est pas notifié.

Normal (« Normal »)

L'utilisateur est notifié.

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

Le système a redémarré avec la dernière configuration connue-correcte.

Critique (« Critique »)

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

Inconnu (« Inconnu »)

L’action effectuée n’est pas spécifiée.

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 »)

Définition des 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.

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_ManagedSystemElement.

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 complet du fichier binaire de service qui implémente le service.

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

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 ExitCodeproperty est ERROR_SERVICE_SPECIFIC_ERROR (1066).

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 »)

Service fourni aux processus d’appel.

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 : Remplacer (« StartMode »), DisplayName (« Mode Démarrer »)

Mode démarrer du service de base Windows.

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

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 être au format « DomainName\Username » ou au format UPN (Username@DomainName). 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 ».

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.

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 »)

Windows Server 2008 et Windows Vista : Cette propriété est en lecture seule.

É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 incluent : « OK », « Détérioré » et « Échec anticipé » (un élément, tel qu’un lecteur de disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non coopératifs incluent : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer lors de la miroir-resilver d’un disque, du rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. 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 notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Détérioré (« Détérioré »)

Inconnu (« Inconnu »)

Échec de la préversion (« Échec prédé »)

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 (« System Class Name »)

Tapez le nom 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 de balise unique pour ce service dans le groupe. La valeur 0 (zéro) indique qu’aucune balise n’a été affectée au service. Une balise peut être utilisée pour classer le service star tup au sein d’un groupe d’ordre de chargement en spécifiant un vecteur d’ordre de balise dans le Registre situé à l’adresse : HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. Les balises sont évaluées uniquement pour les services de type de démarrage du pilote du noyau et du pilote de système de fichiers qui ont le mode Démarrage ou Démarrage du système.

Notes

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

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

CIM_Service
Classes du système d’exploitation

Partager via

classe Win32_BaseService

Syntaxe

Membres

Méthodes

Propriétés

Notes

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires