Qualificatifs des propriétés WMI
Le tableau suivant répertorie les qualificateurs de propriété MOF obligatoires et facultatifs qui peuvent être utilisés pour définir des éléments dans des données WMI ou un bloc d’événements.
Voici les qualificateurs MOF standard : clé, lecture, écriture, ValueMap et Valeurs. Pour plus d’informations sur ces qualificateurs MOF et d’autres qualificateurs MOF standard, consultez Types de données MOF.
| Qualificateur | Description |
|---|---|
key |
Indique que l’élément de données est une propriété clé qui identifie de manière unique chaque instance de la classe. Seule la propriété InstanceName peut être déclarée clé. |
read |
Indique qu’un client WMI peut lire l’élément de données. |
write |
Indique qu’un client WMI peut définir l’élément de données. |
Image matricielle |
Spécifie les positions de bits des valeurs de chaîne correspondantes spécifiées dans BitValues. |
BitValues |
Spécifie une liste de valeurs de chaîne (noms d’indicateurs) qui représentent des bits définis dans l’élément de données. La position du bit d’un indicateur est définie par la position correspondante spécifiée dans BitMap. |
DefineValues |
Spécifie une liste énumérée que la suite d’outils WMI compile dans une liste correspondante d’instructions #define. |
DisplayInHex |
Spécifie que tout client WMI qui affiche la valeur de propriété doit le faire en hexadécimal. |
DisplayName(« string ») |
Spécifie une légende qu’un client WMI peut utiliser pour s’afficher comme nom de propriété. |
MaxLen(uint) |
Pour les propriétés de chaîne, MaxLen spécifie la longueur maximale de la chaîne en caractères. La valeur uint peut être n’importe quel entier non signé 32 bits. Si MaxLen est omis ou que l’interface utilisateur est égale à zéro, la longueur de la chaîne est illimitée. |
Valeurs |
Spécifie une liste des valeurs possibles pour cet élément de données. Si l’élément de données est une énumération, ValueMap contient la valeur d’index qui correspond à la valeur d’énumération spécifiée dans Valeurs. |
ValueMap |
Spécifie les valeurs entières des valeurs de chaîne correspondantes dans Valeurs. |
WmiDataId(data-item-ID) |
(Obligatoire) Identifie un élément de données dans un bloc de données. Les ID d’élément de données doivent être attribués à tous les éléments d’un bloc, à l’exception des éléments requis InstanceName et Active. Les ID d’élément de données doivent être attribués dans une série contiguë, à compter de 1. L’ID de données d’un élément détermine l’ordre dans lequel l’élément apparaît dans une instance du bloc de données ; l’ordre des éléments dans la définition de classe MOF n’est pas pertinent. |
WmiMethodId(method-item-ID) |
Identifie une méthode dans un bloc de données. |
WmiSizeIs(« data-item-name ») |
Spécifie le nom d’un autre élément de données dans ce bloc qui indique le nombre d’éléments dans le tableau de longueur variable à cet élément de données. WmiSizeIs est valide uniquement pour les éléments de données qui définissent des tableaux. |
WmiScale(scale-factor) |
Spécifie le facteur de mise à l’échelle, sous la forme d’une puissance de 10, que le pilote utilise lors du retour de la valeur de cet élément de données. Par exemple, si le facteur d’échelle est égal à 5, la valeur retournée par le pilote est multipliée par 10⁵. Si WmiScale est omis, le facteur d’échelle peut être supposé être égal à 0. |
WmiTimeStamp |
Spécifie qu’un élément de données 64 bits est un horodatage en unités de 100 nanosecondes depuis 1/1/1601. WmiTimeStamp est valide uniquement pour les éléments de données 64 bits. |
WmiComplexity(level) |
Spécifie une valeur entière qui exprime le niveau de complexité utilisateur de l’élément de données. Les clients WMI peuvent utiliser cette valeur pour distinguer les éléments de données qui doivent être disponibles pour les utilisateurs novices et les éléments de données qui doivent être limités à des utilisateurs plus avancés. Zéro est la valeur minimale et les valeurs supérieures indiquent une complexité utilisateur plus élevée. WmiComplexity a la valeur zéro si elle n’est pas spécifiée. |
WmiVolatility(interval) |
Spécifie l’intervalle, en millisecondes, entre les mises à jour de cet élément de données. Par exemple, si un élément de données est mis à jour une fois par seconde, l’intervalle est de 1 000. Un client WMI peut vérifier WmiVolatility pour déterminer la fréquence à laquelle interroger une valeur potentiellement nouvelle. Si WmiVolatility est omis, l’intervalle n’est pas défini. |
WmiEventTrigger( " data-item-name ») |
Spécifie le nom d’un élément de données dans un bloc d’événements qu’un client WMI peut définir pour définir la valeur de déclencheur de l’événement. Par exemple, si l’événement TooHot est qualifié avec WmiEventTrigger(« TooHotTemperature »), un client WMI peut définir TooHotTemperature pour indiquer au pilote d’envoyer l’événement TooHot lorsque l’appareil a atteint la valeur spécifiée par l’utilisateur pour TooHotTemperature. En règle générale, un pilote définit la valeur du déclencheur. En exposant un élément de données WmiEventTrigger , le pilote permet à un client de contrôler lorsqu’un événement particulier est déclenché. |
WmiEventRate(« data-item-name ») |
Spécifie le nom d’un élément de données dans un bloc d’événements qu’un client WMI peut définir pour contrôler la fréquence à laquelle cet événement sera envoyé. Par exemple, si l’élément de données TooHot est qualifié avec WmiEventRate(« SendEventRate »), un utilisateur client WMI peut définir SendEventRate pour indiquer au pilote d’envoyer TooHot à l’intervalle spécifié par l’utilisateur. |