描述
SWbemObject的ReferencesAsync_方法提供了引用当前对象的所有关联类或实例的集合。此方法执行与WQL REFERENCES OF查询执行的功能相同的功能。
PowerBASIC 语法
METHOD ReferencesAsync_ ( _ BYVAL objWbemSink AS IDispatch, _ 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, _ OPTIONAL BYVAL objWbemAsyncContext AS IDispatch _ ) |
参数
objWbemSink
需要。异步接收对象的对象接收器。
strResultClass
包含类名的字符串。如果指定了该参数,则该参数指示返回的关联对象必须属于或从该参数中指定的类派生。
strRole
包含属性名称的字符串。如果指定,则此参数指示返回的关联对象必须限制为源对象扮演特定角色的关联对象。角色由关联的指定属性(必须是引用属性)的名称定义。
bClassesOnly
指示是否应该返回类名称列表的布尔值,而不是类的实际实例。这些是关联对象所属的类。该参数的默认值为FALSE。
bSchemaOnly
指示查询是否适用于模式而不是数据的布尔值。该参数的默认值为FALSE。如果调用此方法的对象是一个类,它只能设置为TRUE。当设置为TRUE时,返回的端点集合表示与模式中的源类适当关联的类。
strRequiredQualifier
包含限定符名称的字符串。如果指定,则此参数指示返回的关联对象必须包含指定的限定符。
iFlags
整数指定操作的附加标志。此参数可以接受以下值。
值 |
含义 |
wbemFlagSendStatus 128 &H80 |
导致异步调用将状态更新发送到对象接收器的SWbemSink.OnProgress事件处理程序。 |
wbemFlagDontSendStatus 0 &H0 |
防止异步调用向对象接收器的OnProgress事件处理程序发送状态更新。 |
wbemFlagUseAmendedQualifiers 131072 &H20000 |
导致Windows Management Instrumentation(WMI)返回具有基类定义的类修改数据。有关详细信息,请参阅本地化WMI类信息. |
objwbemNamedValueSet
通常,这是未定义的。否则,这是一个SWbemNamedValueSet对象,其元素表示正在为请求提供服务的提供商可以使用的上下文信息。支持或要求此类信息的提供者必须记录识别的值名称,值的数据类型,允许的值和语义。
objWbemAsyncContext
这是一个SWbemNamedValueSet对象,返回到对象接收器以识别原始异步调用的源。如果使用相同的对象接收器进行多个异步调用,请使用此参数。要使用此参数,请创建一个SWbemNamedValueSet对象,并使用SWbemNamedValueSet.Add方法添加一个标识您正在进行的异步调用的值。该SWbemNamedValueSet对象返回到对象接收器,可以使用SWbemNamedValueSet.Item方法提取调用的源。有关详细信息,请参阅调用方法.
返回值
此方法没有返回值。如果成功,则接收器每个实例收到OnObjectReady事件。在最后一个实例之后,对象接收器接收OnCompleted事件。
OBJRESULT
错误(名称/十进制/十六进制) |
含义 |
wbemErrAccessDenied -2147217405 &H80041003 |
当前用户没有权限查看指定类的实例。 |
wbemErrFailed -2147217407 &H80041001 |
未指定错误 |
wbemErrInvalidParameter -2147217400 &H80041008 |
指定了无效参数。 |
wbemErrOutOfMemory -2147217402 &H80041006 |
没有足够的内存来完成操作。 |
备注
此通话立即返回。所请求的对象和状态通过发送到objWbemSink中指定的接收器的回调返回给呼叫者。要处理每个对象到达时,创建OnObjectReadyOnObjectReady事件子例程。返回所有对象后,您可以在执行objWbemSink.OnCompleted事件时执行最终处理。
异步回调允许非验证用户向sink提供数据。这对您的脚本和应用程序造成安全隐患。为了消除风险,请使用半异步通信或同步通信。有关详细信息,请参阅调用方法.
有关相关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。 |


