ReferencesTo 方法

描述

SWbemServices对象的ReferencesTo方法返回引用特定源类或实例的所有关联类或实例的集合。此方法执行与REFERENCES OFWQL查询执行的功能相同的功能。

这种方法在半同步模式下被调用。有关详细信息，请参阅调用方法.

PowerBASIC 语法

METHOD ReferencesTo ( _

BYVAL strObjectPath AS WSTRING, _

OPTIONAL BYVAL strResultClass AS WSTRING, _

OPTIONAL BYVAL strRole AS WSTRING, _

OPTIONAL BYVAL bClassesOnly AS INTEGER, _

OPTIONAL BYVAL bSchemaOnly AS INTEGER, _

OPTIONAL BYVAL strRequiredQualifier AS WSTRING, _

OPTIONAL BYVAL iFlags AS LONG, _

OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _

) AS ISWbemObjectSet

参数

strObjectPath

需要。包含此方法的源的对象路径的字符串。有关详细信息，请参阅描述WMI对象的位置.

strResultClass

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

strRole

包含属性名称的字符串。如果指定，则此参数指示返回的关联对象必须限制为源对象扮演特定角色的关联对象。角色由关联的指定属性（必须是引用属性）的名称定义。

bClassesOnly

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

bSchemaOnly

指示查询是否适用于模式而不是数据的布尔值。该参数的默认值为FALSE。如果strObjectPath参数指定类的对象路径，则只能设置为TRUE。当设置为TRUE时，返回的端点集合表示与模式中的源类适当关联的类。

strRequiredQualifier

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

iFlags

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

值	含义
wbemFlagForwardOnly 32 &H20	导致只返回枚举器。前向枚举器通常比传统枚举器更快，使用更少的内存，但不允许调用SWbemObject.Clone_.
wbemFlagBidirectional 0 &H0	导致Windows Management Instrumentation（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	没有足够的内存来完成操作。
wbemFlagUseAmendedQualifiers 131072 &H20000	导致WMI使用基类定义返回类修改数据。

备注

有关相关WQL查询，源实例和关联对象的参考的更多信息，请参阅声明协调人.

要求

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