Qualificateurs WMI standard

La liste suivante répertorie les qualificateurs standard spécifiques à WMI.

Amendement

Type de données : booléen

S’applique à : classes

Indique qu’une classe contient des qualificateurs modifiés qui sont localisés. La valeur par défaut est true.

La classe associée peut être traduite. Pour accéder à la version traduite, utilisez l’identificateur de paramètres régionaux pour construire un nom d’espace de noms.

Ignorer _ GetObject

Type de données : booléen

S’applique à : méthodes

Indique que l’appel de méthode doit passer directement à l’appel ExecMethodAsync du fournisseur plutôt qu’au fournisseur en appelant d’abord un appel à GetObject pour valider le chemin d’accès de l’objet. La valeur par défaut est false. L’utilisation de la fonction de contournement _ GetObject peut améliorer considérablement les performances.

Avant d’utiliser le contournement de _ GetObject, assurez-vous qu’aucune des actions suivantes n’est effectuée :

  • Dérivez une classe de votre classe.
  • Substituez la méthode qui a le qualificateur _ GetObject Bypass .

L’échec de ces précautions peut entraîner l’appel de l’implémentation de la méthode de la classe parente au lieu de la classe enfant. Pour plus d’informations, consultez Utilisation du _ qualificateur GetObject de contournement.

_Clé CIM

Type de données : _ valeur booléenne CIM

S’applique à : Properties

Indique que la propriété associée est une propriété de clé dans CIM, mais pas dans WMI.

CIMType

Type de données : VT _ BSTR

S’applique à : propriétés, méthodes, paramètres

Contient le texte décrivant le type d’une propriété.

ClassContext

Type de données : VT _ BSTR

S’applique à : classes

Indique qu’une classe a des instances associées à plus d’informations fournies dynamiquement par un fournisseur.

Déconseillé

Type de données : _ valeur booléenne CIM

S’applique à : Properties, classes

Indique que la propriété a été remplacée par une autre propriété.

Vidéo

S’applique à : classes, propriétés

UUID de la classe associée.

Dynamique

Type de données : booléen

S’applique à : classes, propriétés

Indique une classe dont les instances sont créées dynamiquement. La valeur de ce qualificateur doit être définie sur true.

DynProps

Type de données : booléen

S’applique à : classes, instances

Indique qu’une instance de contient des valeurs fournies par les fournisseurs de propriétés dynamiques. La valeur par défaut est true.

Vous devez spécifier ce qualificateur sur une telle instance. Seule la valeur true est autorisée.

Des

Type de données : _ valeur booléenne CIM

S’applique à : instances

Indique que la valeur de cette propriété ne peut pas changer pendant la durée de vie de l’instance.

IDENTIFI

Type de données : VT _ I4

S’applique à : propriétés, paramètres

Identifie et séquence de manière unique une propriété ou un paramètre de méthode lorsque les instructions MOF sont générées automatiquement.

Ce qualificateur est requis uniquement pour les paramètres de méthode. Lors de la création de paramètres pour une méthode, les concepteurs de classes doivent commencer par ID (0) pour le premier paramètre et utiliser chaque entier successif pour chaque paramètre successif. Si les qualificateurs d' ID ne sont pas intentionnellement omis, le compilateur MOF génère automatiquement des qualificateurs d' ID .

Été

Type de données : booléen

S’applique à : méthodes

Indique qu’une méthode a une implémentation fournie par un fournisseur.

InstanceContext

Type de données : VT _ BSTR

S’applique à : instances

Indique qu’une instance de contient des valeurs fournies par un fournisseur de propriétés dynamiques.

La valeur est passée au fournisseur de propriétés en tant qu’argument de la méthode IWbemPropertyProvider :: GetProperty .

Paramètres régionaux

Type de données : VT _ BSTR

S’applique à : classes ou instances

Spécifie la langue d’origine pour une classe ou une instance. Pour plus d’informations sur les valeurs de paramètres régionaux, consultez codes de paramètres régionaux.

NamespaceSecuritySDDL

Type de données : tableau de chaînes

S’applique à : instances d’espace de noms

Spécifie un descripteur de sécurité pour l’espace de noms au format SDDL . Pour plus d’informations, consultez définition de la sécurité de l’espace de noms lors de la création de l’espace de noms. La chaîne SDDL est traitée par WMI pour établir la sécurité de l’espace de noms, mais elle n’est pas stockée sous forme de chaîne. Si aucun descripteur de sécurité n’est spécifié, la sécurité par défaut est utilisée. Pour plus d’informations, consultez définition des descripteurs de sécurité espace.

Facultatif

Type de données : booléen

S’applique à : paramètres

Indique qu’un paramètre n’est pas obligatoire et qu’il a une valeur par défaut avec un comportement correct.

Autorisations

Type de données : tableau de chaînes

S’applique à : propriétés, méthodes

Ensemble de valeurs utilisées pour informer le client des privilèges requis pour créer des instances, remplir des propriétés ou exécuter des méthodes. La valeur par défaut est false.

PropertyContext

Type de données : VT _ BSTR

S’applique à : Properties

Indique qu’une propriété d’instance contient des valeurs fournies par les fournisseurs de propriétés dynamiques.

Vous devez spécifier ce qualificateur sur une telle propriété. La valeur est passée au fournisseur de propriétés en tant qu’argument de IWbemPropertyProvider :: GetProperty.

Moteur

Type de données : VT _ BSTR

S’applique à : classes

La valeur de ce qualificateur est le nom du fournisseur dynamique qui fournit des instances de classe et actualise les données d’instance. Ce nom doit être inscrit auprès de WMI en créant une instance de la classe _ _ Win32Provider avec la propriété Name contenant ce nom. Quand ce qualificateur est spécifié sur une classe dont les instances sont fournies dynamiquement, le qualificateur dynamique doit également être spécifié.

RequiresEncryption

Type de données : booléen

S’applique à : instances d’espace de noms

Si la valeur est true, RequiresEncryption marque un espace de noms afin que les applications et les scripts clients doivent se connecter avec l’authentification chiffrée. Le niveau d’authentification doit être défini sur la _ _ _ _ _ confidentialité du niveau Authn C RPC en C++. Dans les scripts ou les Visual Basic, le niveau d’authentification doit être défini sur WbemAuthenticationLevelPktPrivacy. Pour plus d’informations, consultez définition des descripteurs de sécurité espace. Le qualificateur est utilisé dans MOF avec la commande de préprocesseur d’espace de noms pragma.

Pour plus d’informations, consultez définition du niveau de sécurité de processus par défaut à l’aide de C++ ou définition du niveau de sécurité de processus par défaut à l’aide de VBScript. Les niveaux d’authentification de script sont définis dans WbemAuthenticationLevelEnum.

Singleton

Type de données : booléen

S’applique à : classes

Désigne une classe qui ne peut avoir qu’une seule instance et qui ne contient pas de propriétés de clé.

Seule la valeur true (valeur par défaut) est autorisée.

Statique

Type de données : booléen

S’applique à : méthodes

Indique si une méthode peut être appelée à l’aide de la définition de classe ou de ses instances.

La méthode ne peut pas être appelée à partir d’une instance.

Sous-type

Type de données : VT _ BSTR

S’applique à : Properties

Indique qu’une propriété de type _ DateTime CIM représente un intervalle de temps plutôt qu’une heure spécifique.

Pour identifier la propriété en tant qu’intervalle, la valeur de ce qualificateur doit être « Interval ». Toutes les autres valeurs de ce qualificateur sont réservées pour une utilisation ultérieure.

UNIVERSEL

Type de données : chaîne

S’applique à : classes

Identificateur unique universel appliqué à la classe.

ClassVersion

Type de données : chaîne

S’applique à : classes

Numéro de version de l’objet de classe. La valeur par défaut est null. Le numéro de version est incrémenté lorsque des modifications sont apportées à la classe.

WritePrivileges

Type de données : tableau de chaînes

S’applique à : Properties

Ensemble de valeurs indiquant les privilèges système qui doivent être disponibles et activés pour une opération d’écriture réussie.

Notes

Codes de paramètres régionaux

Un code de paramètres régionaux se présente sous la forme « MS _ ». Par exemple, les paramètres régionaux anglais sont MS _ 409. Le tableau suivant répertorie les ID de langue.

Language ID de langue (hexadécimal)
Arabe 401
Portugais (Brésil) 416
Chinois (simplifié) 804
Chinois (traditionnel) 404
Tchèque 405
Danois 406
Néerlandais 413
Anglais (par défaut) 409
Finnois 40b
Français 40c
Allemand 407
Grec 408
Hébreu 40d
Hongrois 40e
Italien 410
Japonais 411
Coréen 412
Norvégien 414
Polonais 415
Portugais (Portugal) 816
Russe 419
Espagnol c0a
Suédois 41D
Turc 41f

Utilisation du _ qualificateur GetObject Bypass

L’utilisation du qualificateur _ GetObject de contournement sur une méthode peut produire des résultats confuss.

L’exemple suivant définit les classes Shape et Circle . Notez que la classe Circle est dérivée de la classe Shape .

class Shape
{
   string Name;
   uint32 DrawIt();  // - draws an irregular geometric shape
};

class Circle : Shape
{
   uint32 DrawIt();  // - draws a circle
};

L’appel suivant à ExecMethod utilise un objet Circle nommé « MyCircle » pour dessiner un cercle.

ExecMethod("Shape.Name='MyCircle'","DrawIt");

Dans le scénario précédent, WMI appelle GetObject; Découvre que « Shape. Name = 'MyCircle' » est un cercle; et exécute l’implémentation de Circle de DrawIt. Toutefois, si vous utilisez le qualificateur _ GetObject du contournement sur DrawIt, WMI n’appelle pas GetObject, ne découvre pas que « Shape. Name = 'MyCircle' » est un cercle et exécute l’implémentation de la forme de DrawIt au lieu de l’implémentation de Circle de DrawIt.

L’appel suivant à ExecMethod appelle toujours l’implémentation correcte de DrawIt.

ExecMethod("Circle.Name='MyCircle'","DrawIt");

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008

Voir aussi

Définition des descripteurs de sécurité espace

Qualificateurs WMI

Ajout d’un qualificateur