特定于视图提供程序的限定符
下面列出了用于定义视图提供程序类的限定符。
注意
使用远程引用时,View 提供程序类仅支持 NetBIOS 名称。 如果在远程引用中使用 IP 地址或 DNS 名称,则连接会失败并出现 0x800706ba 错误。
Direct
数据类型:boolean
与视图关联属性一起使用,以防止关联引用映射到视图引用。
以下示例将 GroupComponent 属性定义为未在视图引用中映射的关联引用。
[Direct, key, PropertySources
{"GroupComponent"}]
HiddenDefault
数据类型:boolean
视图类属性的默认值基于具有不同默认值的源类属性。 基础源类由视图暗含表示。
例如,源类 Win32_ScheduledJob 具有一个布尔属性 RunRepeatedly,该属性指示作业是定期执行还是只执行一次。 对于 Win32_ScheduledJob,RunRepeatedly 的默认值不是 True,但视图类的默认值为 True。
#pragma namespace("\\\\.\\root\\ns_view")
[Union,
ViewSources{"select * from Win32_ScheduledJob where RunRepeatedly=True"},
ViewSpaces{"\\\\.\\root\\cimv2"},
dynamic,provider("MS_VIEW_INSTANCE_PROVIDER")]
Class View_PeriodicJob
{
[key, PropertySources{"JobId"}]
uint32 JobId;
[PropertySources{"Command"}]
string Command;
[HiddenDefault,PropertySources{"RunRepeatedly"}]
boolean Repeat = True;
};
JoinOn
数据类型:字符串
定义源类实例在联接视图类中的联接方式。 以下示例演示如何使用 JoinOn 限定符联接两个源类。
JoinOn("Win32Perf_RawProcess.IDProcess = Win32Perf_RawThread.IDProcess")
MethodSource
数据类型:字符串数组
要为视图方法执行的源方法。 有关类似语法,请参阅 PropertySources 限定符。 方法的签名必须与源类的签名完全匹配。 从定义源类的 MOF 文件复制方法签名。 下面的示例根据 Win32_NTEventlogFile 中的 ClearEventLog 方法定义了一种方法:
[implemented, MethodSource
{"ClearEventlog"}]
uint32 VClearEventlog([in] string ArchiveFileName);
此限定符仅在与联合视图一起使用时才有效。
数据类型:字符串
WQL 查询,用于在联接类中联接实例后筛选实例。
数据类型:字符串数组
视图类属性从中获取数据的源属性。
Union
数据类型:boolean
指示是否要定义联合类。 联合视图包含基于源实例联合的实例。 例如,可以声明以下内容:
Union, ViewSources{"SELECT Handle, Name, CreationDate FROM Win32_Process",
"SELECT Caption, Name, ProcessHandle FROM Win32_Thread"}.
数据类型:字符串数组
WMI 查询语言 (WQL) 查询的集合,这些查询定义了特定视图类中使用的源实例和属性。 所有数组限定符的位置对应很重要。
数据类型:字符串数组
源实例所在的命名空间。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |