SWbemObject.References_ 方法

SWbemObject 对象的 References\_ 方法返回引用当前对象的所有关联类或实例的集合。

此方法执行的函数与 REFERENCES OF WQL 查询相同。

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

语法

objWbemObjectSet = .References_( _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

parameters

strResultClass [in, optional]

包含类名的字符串。 如果指定此参数,则它指示返回的关联对象必须属于或派生自此参数中指定的类。

strRole [in, optional]

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

bClassesOnly [in, optional]

一个布尔值,指示是否应返回类名列表而不是类的实际实例。 这些是关联对象所属的类。 此参数的默认值为 FALSE。

bSchemaOnly [in, optional]

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

strRequiredQualifier [in, optional]

包含限定符名称的字符串。 如果指定此参数,则它指示返回的关联对象必须包含指定的限定符。

iFlags [in, optional]

指定操作附加标志的整数。 此参数的默认值是 wbemFlagReturnImmediately,用于指示直接返回调用,而不是等待查询完成。 此参数可以接受以下值。

wbemFlagForwardOnly (32 (0x20))

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

wbemFlagBidirectional (0 (0x0))

使 Windows Management Instrumentation (WMI) 保留指向枚举对象的指针,直到客户端释放枚举器。

wbemFlagReturnImmediately (16 (0x10))

使调用立即返回。

wbemFlagReturnWhenComplete (0 (0x0))

使此调用被阻止,直到查询完成。

wbemFlagUseAmendedQualifiers (131072 (0x20000))

使 WMI 返回类修改数据以及基类定义。 有关已修正的限定符的详细信息,请参阅本地化 WMI 类信息

objwbemNamedValueSet [in, optional]

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

返回值

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

错误代码

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

wbemErrAccessDenied - 2147749891 (0x80041003)

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

wbemErrFailed - 2147749889 (0x80041001)

错误。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定的参数无效。

wbemErrOutOfMemory - 2147749894 (0x80041006)

内存不足,无法完成此操作。

备注

有关 REFERENCES OF 关联的 WQL 查询、源实例和关联对象的详细信息,请参阅 ASSOCIATORS OF 语句

要求

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

另请参阅

SWbemObject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo