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 ] _
)

参数

strObjectPath

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

strAssocClass [可选]

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

strResultClass [可选]

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

strResultRole [可选]

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

strRole [可选]

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

bClassesOnly [可选]

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

bSchemaOnly [可选]

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

strRequiredAssocQualifier [可选]

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

strRequiredQualifier [可选]

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

iFlags [可选]

指定操作的其他标志的整数。 此参数的默认值为 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