Qualificateurs de propriété WMI

Le tableau suivant répertorie les qualificateurs de propriétés MOF obligatoires et facultatifs qui peuvent être utilisés pour définir des éléments dans un bloc de données ou d’événements WMI.

Voici les qualificateurs MOF standard : key, read, write, ValueMap et Values. Pour plus d’informations sur ces 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.
Bitmap	Spécifie les positions de bits des valeurs de chaîne correspondantes qui sont 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 de 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 la propriété doit le faire en hexadécimal.
DisplayName(« string »)	Spécifie un légende qu’un client WMI peut utiliser pour 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 si uint est égal à zéro, la longueur de la chaîne est illimitée.
Valeurs	Spécifie une liste de 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ë, à partir de 1. L’ID de données d’un élément détermine l’ordre dans lequel l’élément apparaît dans un instance du bloc de données ; l’ordre des éléments dans la définition de la 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 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 le 1/1/1601. WmiTimeStamp est valide uniquement pour les éléments de données 64 bits.
WmiComplexité(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 faire la distinction entre 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 aux utilisateurs plus avancés. Zéro est la valeur minimale, et les valeurs supérieures indiquent une plus grande complexité de l’utilisateur. La valeur par défaut de WmiComplexity est égale à 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 case activée 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 pour 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 quand 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.