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