Partager via


Qualificateurs WMI standard

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

Amendment

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.

Bypass_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 effectuant 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 qu’aucune des actions suivantes n’est effectuée :

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

Le non-respect 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 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 a des instances associées à plus d’informations fournies dynamiquement par un fournisseur.

Déconseillé

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

Le 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 un tel 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 du 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 des 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 sont omis involontairement, le compilateur MOF génère automatiquement des qualificateurs d’ID .

Implémenté

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

Locale

Type de données : VT_BSTR

S’applique à : classes ou instances

Spécifie la langue d’origine d’une classe ou d’un instance. Pour plus d’informations sur les valeurs de 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 Réglages de sécurité durant la création d’un espace de noms. 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.

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 bien élevée.

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

Vous devez spécifier ce qualificateur sur une telle propriété. La valeur est transmise au fournisseur de propriétés en tant qu’argument à la méthode 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 instance données. Ce nom doit être inscrit auprès de WMI en créant un 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 doivent se connecter avec 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 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 préprocesseur d’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é du 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.

Static

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’un instance.

SubType

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

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 principale de l’objet de schéma. 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 les privilèges système qui 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_< ID de langue> du chiffre ». 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 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");

Spécifications

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é d’espace de noms

Qualificateurs WMI

Ajout d’un qualificateur