SWbemServices.AssociatorsOf 方法

SWbemServices 对象的 AssociatorsOf 方法返回与指定对象关联的对象（类或实例，称为终结点）集合。 此方法执行的函数与 ASSOCIATORS OF WQL 查询执行的函数相同。

默认情况下，此方法是以半同步模式调用的。 有关详细信息，请参阅调用方法。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

objWbemObjectSet = .AssociatorsOf( _
  ByVal strObjectPath, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

parameters

strObjectPath

必需。 包含源类或实例的对象路径的字符串。 有关详细信息，请参阅描述 WMI 对象的位置。

strAssocClass [optional]

包含关联类的字符串。 如果指定此参数，则它指示必须通过指定的关联类或派生自此关联类的类将返回的终结点与源相关联。

strResultClass [optional]

包含类名的字符串。 如果指定此可选参数，则它指示返回的终结点必须属于或派生自此参数中指定的类。

strResultRole [optional]

包含属性名称的字符串。 如果指定此参数，则它指示返回的终结点在与源对象的关联中必须发挥特定作用。 此角色由指定的关联属性（必须是引用属性）的名称定义。

strRole [optional]

包含属性名称的字符串。 如果指定此参数，则它指示返回的终结点必须参与与源对象的关联，源对象在其中发挥特定作用。 此作用由指定的关联属性（必须是引用属性）的名称定义。

bClassesOnly [optional]

一个布尔值，指示是否应返回类名列表而不是类的实际实例。 这些是终结点实例所属的类。 此参数的默认值为 FALSE。

bSchemaOnly [optional]

一个布尔值，指示查询是否应用于架构而不是数据。 此参数的默认值为 FALSE。 仅当 strObjectPath 参数指定类的对象路径时，才能将其设置为 TRUE。 如果设置为 TRUE，则返回的终结点集表示与架构中的源类适当关联的类。

strRequiredAssocQualifier [optional]

包含限定符名称的字符串。 如果指定此参数，则它指示必须通过包含指定限定符的关联类将返回的终结点与源对象相关联。

strRequiredQualifier [optional]

包含限定符名称的字符串。 如果指定此参数，则它指示返回的终结点必须包含指定的限定符。

iFlags [optional]

指定操作附加标志的整数。 此参数的默认值为 wbemFlagReturnImmediately，即以半同步模式调用方法。 此参数可以接受以下值。

wbemFlagForwardOnly (32 (0x20))

导致返回只进枚举器。 通常，相较于传统枚举器，只进枚举器快得多并且使用的内存更少，但它们不允许调用 SWbemObject.Clone_。

wbemFlagBidirectional (0 (0x0))

使 WMI 保留指向枚举对象的指针，直到客户端释放枚举器。

wbemFlagReturnImmediately (16 (0x10))

使调用立即返回。

wbemFlagReturnWhenComplete (0 (0x0))

使此调用被阻止，直到查询完成。 此标志在同步模式下调用方法。

wbemFlagUseAmendedQualifiers (131072 (0x20000))

使 WMI 返回类修改数据以及基类定义。 有关详细信息，请参阅本地化 WMI 类信息。

objwbemNamedValueSet [可选]

通常，未定义此参数。 如果已定义，此参数是一个 SWbemNamedValueSet 对象，其元素表示可供提供请求服务的提供程序使用的上下文信息。 支持或需要此类信息的提供程序必须记录已识别的值名称、值数据类型、允许的值和语义。

返回值

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

错误代码

AssociatorsOf 方法完成后，Err 对象可能包含以下列表中的错误代码之一。

注意

返回的集合包含零元素并非错误。

wbemErrAccessDenied - 2147749891 (0x80041003)

当前用户无权查看调用返回的一个或多个类。

wbemErrFailed - 2147749889 (0x80041001)

错误。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定的参数无效。

wbemErrOutOfMemory - 2147749894 (0x80041006)

内存不足，无法完成操作。

wbemErrNotFound - 2147749890 (0x80041002)

找不到请求的项。

备注

该方法通过一个或多个关联类检索与指定资源关联的托管资源的实例。 提供原始终结点的对象路径，AssociatorsOf 返回相反终结点处的托管资源。 AssociatorsOf 方法执行的函数与 ASSOCIATORS OF WQL 查询执行的函数相同。

有关 ASSOCIATORS OF WQL 查询、源实例和终结点的详细信息，请参阅 ASSOCIATORS OF 语句。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Wbemdisp.h
类型库	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

另请参阅

SWbemServices

SWbemObject.Associators_

SWbemObject.AssociatorsAsync_

SWbemServices.AssociatorsOfAsync

SWbemObject.References_

SWbemServices.ReferencesTo