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

Bypass_GetObject

Type de données : booléen

S’applique aux méthodes suivantes :

Indique que l’appel de méthode doit passer directement à l’appel ExecMethodAsync du fournisseur plutôt que le fournisseur qui effectue 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 Bypass_GetObject peut améliorer considérablement les performances.

Avant d’utiliser Bypass_GetObject, vérifiez que l’une des actions suivantes n’est pas effectuée :

  • Dérivez une classe de votre classe.
  • Remplacez la méthode qui a le qualificateur Bypass_GetObject .

Le fait de ne pas suivre 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 Bypass_GetObject.

CIM_Key

Type de données : CIM_BOOLEAN

S’applique à : propriétés

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

CIMType

Type de données : VT_BSTR

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

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

ClassContext

Type de données : VT_BSTR

S’applique à : classes

Indique qu’une classe possède des instances associées à des informations supplémentaires fournies dynamiquement par un fournisseur.

Déconseillée

Type de données : CIM_BOOLEAN

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

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

Affichage

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 contient des valeurs fournies par des 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.

Fixe

Type de données : CIM_BOOLEAN

S’applique à : instances

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

ID

Type de données : VT_I4

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

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

Ce qualificateur est requis pour les paramètres de méthode uniquement. 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 sont omis involontairement, le compilateur MOF génère automatiquement des qualificateurs d’ID .

Implémenté

Type de données : booléen

S’applique aux méthodes suivantes :

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 contient des valeurs fournies par un fournisseur de propriétés dynamiques.

La valeur est transmise au fournisseur de propriétés en tant qu’argument à 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 d’une classe ou d’une instance. Pour plus d’informations sur les valeurs des paramètres régionaux, consultez Codes 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 lorsque l’espace de noms est créé. La chaîne SDDL est traitée par WMI pour établir la sécurité de l’espace de noms, mais pas stockée en tant que 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é Namepace.

Optionnel

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 bien comporte.

Privilèges

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 effectuer des méthodes. La valeur par défaut est FALSE.

PropertyContext

Type de données : VT_BSTR

S’applique à : propriétés

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 à IWbemPropertyProvider::GetProperty.

Fournisseur

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. Lorsque 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 clientes et les scripts puissent se connecter à l’authentification chiffrée. Le niveau d’authentification doit être défini sur RPC_C_AUTHN_LEVEL_PKT_PRIVACY 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é Namepace. Le qualificateur est utilisé dans MOF avec la commande de préprocesseur de l’espace de noms pragma.

Pour plus d’informations, consultez Définition du niveau de sécurité du 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 à : propriétés

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

Pour identifier la propriété comme 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.

UUID

Type de données : chaîne

S’applique à : classes

Identificateur unique universellement 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 à : propriétés

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

Notes

Codes régionaux

Un code de paramètres régionaux se présente sous la forme « MS_<Three Digit Language ID> ». Par exemple, les paramètres régionaux anglais sont MS_409. Le tableau suivant répertorie les ID de langue.

Langage 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 de Bypass_GetObject

L’utilisation du qualificateur Bypass_GetObject sur une méthode peut produire des résultats confus.

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 circle de DrawIt. Toutefois, si vous utilisez le qualificateur Bypass_GetObject sur DrawIt, WMI n’appelle pas GetObject, ne découvre pas que « Shape.Name=' MyCircle » est un cercle et exécute l’implémentation Shape de DrawIt au lieu de l’implémentation 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é Namepace

Qualificateurs WMI

Ajout d’un qualificateur