classe CIM_Service (fournisseurs WMI CIMWin32)
La classe CIM_Service représente un élément logique qui contient des informations pour représenter et gérer les fonctionnalités fournies par une fonctionnalité d’appareil ou de logiciel. Un service est un objet à usage général permettant de configurer et de gérer l’implémentation de fonctionnalités ; il ne s’agit pas de la fonctionnalité elle-même.
Important
Les classes CIM (Common Information Model) DMTF (Distributed Management Task Force) sont les classes parentes sur lesquelles les classes WMI sont créées. WMI prend actuellement uniquement en charge les schémas de version CIM 2.x.
La syntaxe suivante est simplifiée à partir de code au format 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
[Abstract, UUID("{8502C527-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("Services (CIM)"), AMENDMENT]
class CIM_Service : CIM_LogicalElement
{
string Caption;
string Description;
datetime InstallDate;
string Status;
string CreationClassName;
string Name;
boolean Started;
string StartMode;
string SystemCreationClassName;
string SystemName;
};
Membres
La classe CIM_Service a les types de membres suivants :
Méthodes
La classe CIM_Service possède ces méthodes.
| Méthode | Description |
|---|---|
| StartService | Tente de placer le service dans son état de démarrage. Non implémenté par WMI. |
| StopService | Méthode de classe qui place le service à l’état arrêté. Non implémenté par WMI. |
Propriétés
La classe CIM_Service possède ces propriétés.
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), DisplayName (« Caption »)
Brève description textuelle 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 classe ou de la sous-classe utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec d’autres propriétés clés de la classe, cette propriété permet à toutes les instances de la classe et de ses sous-classes d’être identifiées de manière unique.
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Description »)
Description textuelle de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
InstallDate
-
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)
Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.
Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
Nom
-
La propriété Name identifie de manière unique le service et 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.
-
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é »)
Si la valeur EST TRUE, le service a démarré.
-
-
StartMode
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Mode Démarrer »)
Indique si le service est démarré automatiquement (par exemple, par un système d’exploitation) ou démarré uniquement sur demande.
-
-
Automatique (« Automatique »)
-
Manuel (« Manuel »)
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName (« Status »)
Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).
Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir 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 notamment les suivantes :
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 de la classe de création du système d’étendue.
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 le service.
Notes
La classe CIM_Service est dérivée de CIM_LogicalDevice.
WMI n’implémente pas cette classe. Pour les classes WMI dérivées de CIM_Service, consultez Classes Win32.
Cette documentation est dérivée des descriptions de classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du Kit de développement logiciel (SDK) Microsoft ou fournir des informations supplémentaires.
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 |
|