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

Associators_ Method

Previous pageReturn to chapter overviewNext page

描述

 

SWbemObject对象的Associators_方法返回与当前对象关联的对象(类或实例)的集合。这些返回的对象称为端点。此方法执行与WQL查询的ASSOCIATORS执行的功能相同的功能。

 

PowerBASIC 语法

 

METHOD Associators_ ( _

OPTIONAL BYVAL strAssocClass AS WSTRING, _

OPTIONAL BYVAL strResultClass AS WSTRING, _

OPTIONAL BYVAL strResultRole AS WSTRING, _

OPTIONAL BYVAL strRole AS WSTRING, _

OPTIONAL BYVAL bClassesOnly AS INTEGER, _

OPTIONAL BYVAL bSchemaOnly AS INTEGER, _

OPTIONAL BYVAL strRequiredAssocQualifier AS WSTRING, _

OPTIONAL BYVAL strRequiredQualifier AS WSTRING, _

OPTIONAL BYVAL iFlags AS LONG, _

OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _

) AS ISWbemObjectSet

 

参数

 

strAssocClass

 

包含关联类的字符串。如果指定,则此参数指示返回的端点必须通过指定的关联类或从此关联类派生的类与源相关联。

 

strResultClass

 

包含类名的字符串。如果指定了此参数,则该参数表示返回的端点必须属于或从此参数中指定的类派生。

 

strResultRole

 

包含属性名称的字符串。如果指定,则该参数指示返回的端点必须在与源对象的关联中发挥特定的作用。角色由关联的指定属性(必须是引用属性)的名称定义。

 

strRole

 

包含属性名称的字符串。如果指定,则该参数指示返回的端点必须参与与源对象扮演特定角色的源对象的关联。角色由关联的指定属性(必须是引用属性)的名称定义。

 

bClassesOnly

 

指示是否应返回类名称列表的布尔值,而不是类的实际实例。这些是端点实例所属的类。该参数的默认值为FALSE。

 

bSchemaOnly

 

这是一个布尔值,指示查询是应用于模式而不是数据。该参数的默认值为FALSE。如果调用此方法的对象是一个类,它只能设置为TRUE。当设置为TRUE时,返回的端点集合表示与模式中的源类适当关联的类。

 

strRequiredAssocQualifier

 

包含限定符名称的字符串。此参数(如果指定)指示返回的端点必须通过包含指定限定符的关联类与源对象关联。

 

strRequiredQualifier

 

包含限定符名称的字符串。此参数(如果指定)指示返回的端点必须包含指定的限定符。

 

iFlags

 

整数指定操作的附加标志。此参数的默认值为wbemFlagReturnImmediately,它会引导呼叫立即返回,而不是等到查询完成。此参数可以接受以下值。

 

含义

wbemFlagForwardOnly

32

&H20

导致只返回枚举器。前向枚举器通常比传统枚举器更快,使用更少的内存,但不允许调用SWbemObject.Clone_.

wbemFlagBidirectional

0

&H0

导致WMI保留枚举对象的指针,直到客户端释放枚举器。

wbemFlagReturnImmediately

16

&H10

使呼叫立即返回。

wbemFlagReturnWhenComplete

0

&H0

导致此调用阻止,直到查询完成。

wbemFlagUseAmendedQualifiers

131072

&H20000

导致WMI使用基类定义返回类修改数据。包括此标志使本地化描述限定符文本可用于类,属性和方法。有关修订限定词的更多信息,请参阅本地化WMI类信息.

 

objWbemNamedValueSet

 

通常,这是未定义的。否则,这是一个SWbemNamedValueSet对象,其元素表示正在为请求提供服务的提供者可以使用的上下文信息。支持或要求此类信息的提供者必须记录识别的值名称,值的数据类型,允许的值和语义。

 

返回值

 

如果调用成功,则返回SWbemObjectSet对象。

 

OBJRESULT

 

错误(名称/十进制/十六进制)

含义

wbemErrAccessDenied

-2147217405

&H80041003

当前用户没有权限查看通话返回的一个或多个类。

wbemErrFailed

-2147217407

&H80041001

未指定错误

wbemErrInvalidParameter

-2147217400

&H80041008

指定了无效参数。

wbemErrOutOfMemory

-2147217402

&H80041006

没有足够的内存来完成操作。

 

备注

 

有关关联的WQL查询,源实例和端点的ASSOCIATORS的更多信息,请参阅声明协调人.

 

要求

 

客户

需要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。

Wbemdisp.inc。

DLL

需要Wbemdisp.dll。