特定于视图提供程序的限定符

下面列出了用于定义视图提供程序类的限定符。

注意

使用远程引用时,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);

此限定符仅在与联合视图一起使用时才有效。

PostJoinFilter

数据类型:字符串

WQL 查询,用于在联接类中联接实例后筛选实例。

PropertySources

数据类型:字符串数组

视图类属性从中获取数据的源属性。

Union

数据类型:boolean

指示是否要定义联合类。 联合视图包含基于源实例联合的实例。 例如,可以声明以下内容:

Union, ViewSources{"SELECT Handle, Name, CreationDate FROM Win32_Process", 
                   "SELECT Caption, Name, ProcessHandle FROM Win32_Thread"}.

ViewSources

数据类型:字符串数组

WMI 查询语言 (WQL) 查询的集合,这些查询定义了特定视图类中使用的源实例和属性。 所有数组限定符的位置对应很重要。

ViewSpaces

数据类型:字符串数组

源实例所在的命名空间。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008