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