WMI 属性限定符
下表列出了可用于定义 WMI 数据或事件块中的项的必需和可选的 MOF 属性限定符。
以下是标准 MOF 限定符： 键、 读取、 写入、 ValueMap 和 值。 有关这些条件和其他标准 MOF 限定符的详细信息，请参阅 MOF 数据类型。
| Qualifier | 说明 |
|---|---|
键 |
指示数据项是唯一标识类的每个实例的键属性。 只能声明 InstanceName 属性。 |
read |
指示 WMI 客户端可以读取数据项。 |
write |
指示 WMI 客户端可以设置数据项。 |
位图 |
指定 BitValues 中指定的相应字符串值的位位置。 |
BitValues |
指定表示数据项中设置的位的字符串值（标志名称）的列表。 标志的位位置由 BitMap 中指定的相应位置定义。 |
DefineValues |
指定 WMI 工具套件编译为相应 #define 语句列表的枚举列表。 |
DisplayInHex |
指定任何显示属性值的 WMI 客户端应在十六进制中执行此操作。 |
DisplayName（“string”） |
指定 WMI 客户端可用于显示为属性名称的标题。 |
MaxLen（uint） |
对于字符串属性， MaxLen 指定字符串的最大长度（以字符为单位）。 uint 值可以是任何 32 位无符号整数。 如果省略 MaxLen 或 uint 为零，则字符串的长度不受限制。 |
值 |
指定此数据项的可能值的列表。 如果数据项是枚举，则 ValueMap 包含与 Values 中指定的枚举值相对应的索引值。 |
ValueMap |
指定 Values 中相应字符串值的整数值。 |
WmiDataId（data-item-ID） |
（必需）标识数据块中的数据项。 必须将数据项 ID 分配给块中的所有项，但必需项 InstanceName 和 Active 除外。 必须在连续序列中分配数据项 ID，从 1 开始。 项的数据 ID 确定项在数据块实例中显示的顺序;MOF 类定义中项的顺序无关紧要。 |
WmiMethodId（method-item-ID） |
标识数据块中的方法。 |
WmiSizeIs（“data-item-name”） |
指定此块中另一个数据项的名称，该名称指示此数据项中可变长度数组中的元素数。 WmiSizeIs 仅适用于定义数组的数据项。 |
WmiScale（缩放因子） |
指定缩放因子（以 10 为幂），驱动程序在返回此数据项的值时使用。 例如，如果 刻度系数 为 5，则驱动程序返回的值乘以 10⁵。 如果 省略 WmiScale ， 则可以假定缩放因子 为 0。 |
WmiTimeStamp |
指定 64 位数据项是自 1/1/1/1601 以来的 100 纳秒单位的时间戳。 WmiTimeStamp 仅对 64 位数据项有效。 |
WmiComplexity（level） |
指定表示数据项的用户复杂性级别的整数值。 WMI 客户端可以使用该值来区分应提供给新手用户的数据项和数据项，而数据项应限制为更高级的用户。 零是最小值，较高的值表示更高的用户复杂性。 如果未指定，WmiComplexity 默认为零。 |
WmiVolatility（interval） |
指定此数据项更新之间的间隔（以毫秒为单位）。 例如，如果数据项每秒更新一次， 则间隔 为 1000。 WMI 客户端可能会检查 WmiVolatility ，以确定查询潜在新值的频率。 如果 省略 WmiVolatility ， 则间隔 未定义。 |
WmiEventTrigger（“data-item-name”） |
指定事件块中数据项的名称，WMI 客户端可以设置为定义事件的触发器值。 例如，如果事件 TooHot 使用 WmiEventTrigger（“TooHotTemperature”）进行限定，则 WMI 客户端可以设置 TooHotTemperature，以指示驱动程序在设备达到 TooHotTemperature 的用户指定值时发送 TooHot 事件。 通常，驱动程序将定义触发器值。 通过公开 WmiEventTrigger 数据项，驱动程序允许客户端控制何时触发特定事件。 |
WmiEventRate（“data-item-name”） |
指定事件块中数据项的名称，WMI 客户端可以设置为控制发送此事件的频率。 例如，如果数据项 TooHot 使用 WmiEventRate（“SendEventRate”）进行限定，则 WMI 客户端用户可以设置 SendEventRate 以指示驱动程序按用户指定的时间间隔发送 TooHot。 |