勇芳软件工作室.汉化:  Windows Management Instrumentation > Scripting API for WMI > Scripting API Objects >

SWbemNamedValueSet

Previous pageReturn to chapter overviewNext page

SWbemNamedValueSet对象是SWbemNamedValue对象的集合。SWbemNamedValueSet的方法和属性主要用于在向WMI提交某些呼叫时向提供商发送更多信息。SWbemServices中的所有来电,以及SWbemObject中的一些电话都会使用可选参数,该参数是此类型的对象。客户端可以向SWbemNamedValueSet对象添加信息,并将该呼叫作为参数之一发送给SWbemNamedValueSet对象。该对象可以由VBScript CreateObject调用创建。

 

有关详细信息,请参阅访问集合.

 

注意重要 - 如果可能,请勿使用此机制,因为它可能会破坏作为WMI基础的统一访问模型。如果提供者确实使用这种机制,那么尽可能少地使用这种机制很重要。如果提供商需要大量高度特定的上下文信息来响应请求,则必须对所有客户端进行编码以提供此信息。如果需要,这种机制允许您访问此类提供程序。

 

SWbemNamedValueSet对象是SWbemNamedValue元素的集合。这些项目将使用SWbemNamedValueSet.Add方法添加到集合中。它们使用SWbemNamedValueSet.Remove方法删除并使用SWbemNamedValueSet.Item方法检索。您可以访问方法来填写动态提供程序所需的任何上下文信息。在调用SWbemServices方法之一后,您可以将SWbemNamedValueSet对象重用于另一个调用。

 

底层提供程序确定SWbemNamedValueSet对象中包含的信息。WMI不会使用这些信息,而是将其转发给提供商。提供者必须发布他们需要的服务请求的上下文信息。

 

方法

 

SWbemNamedValueSet对象定义了以下方法。

 

方法

描述

向集合添加SWbemNamedValue对象。

克隆

复制此SWbemNamedValueSet集合。

DeleteAll

从集合中删除所有项目,使SWbemNamedValueSet对象为空。

项目

从集合中检索SWbemNamedValue对象。这是对象的默认方法。

去掉

从集合中删除SWbemNamedValue对象。

 

属性

 

SWbemNamedValueSet对象定义了以下属性。

 

属性

描述

计数

集合中的项目数。

 

要求

 

客户

需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95 OSR2及更高版本。

服务器

需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。

类型库

使用Wbemdisp.tlb。

DLL

需要Wbemdisp.dll。