勇芳软件工作室.汉化:  Windows Management Instrumentation > Scripting API for WMI > Scripting API Objects > SWbemServices >

ReferencesToAsync Method

Previous pageReturn to chapter overviewNext page

描述

 

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

 

有关异步模式的更多信息,请参阅调用方法.

 

PowerBASIC 语法

 

METHOD ReferencesToAsync ( _

BYVAL objWbemSink AS IDispatch, _

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, _

OPTIONAL BYVAL objWbemAsyncContext AS IDispatch _

)

 

参数

 

objWbemSink

 

需要。异步接收对象的对象接收器。创建一个SWbemSink对象来接收对象。

 

strObjectPath

 

需要。包含此方法的源的对象路径的字符串。有关详细信息,请参阅本地化WMI类信息.

 

strResultClass

 

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

 

strRole

 

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

 

bClassesOnly

 

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

 

bSchemaOnly

 

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

 

strRequiredQualifier

 

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

 

iFlags

 

指定操作的附加标志的整数。此参数的默认值为wbemFlagBidirectional.此参数可以接受以下值。

 

含义

wbemFlagSendStatus

128

&H80

导致异步调用将状态更新发送到对象接收器的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中指定的接收器的回调函数返回给调用者。要处理每个对象返回时,创建OnObjectReady事件子例程。返回所有对象后,您可以在执行objWbemSink.OnCompleted事件时执行最终处理。

 

异步回调允许非验证用户向sink提供数据。这对您的脚本和应用程序造成安全隐患。要消除风险,请参阅设置异步调用的安全性.

 

要求

 

客户

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