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

OnObjectReady Event

Previous pageReturn to chapter overviewNext page

描述

 

当异步操作返回一个对象时,会触发SWbemSink对象的OnObjectReady事件。使用此事件来处理来自异步调用的对象,例如SWbemObject.InstancesAsync_SWbemServices.ExecQueryAsync.OnObjectReady每次返回一个SWbemObject,直到枚举完成。

 

PowerBASIC 语法

 

METHOD OnObjectReady ( _

BYVAL objWbemObject AS ISWbemObject, _

BYVAL objWbemAsyncContext AS ISWbemNamedValueSet _

)

 

参数

 

objWbemObject

 

一个SWbemObject对象。这与触发此事件的异步调用的同步等效返回的相似。例如,对SWbemServices.GetAsync方法的调用将返回SWbemSink对象OnObjectReady事件的objWbemObject参数中的SWbemObject,该参数作为原始调用的objWbemObject参数传递。通过使用与SWbemServices.Get的等效同步调用,可以获得相同的SWbemObject对象。

 

objWbemAsyncContext

 

传递给原始异步调用的SWbemNamedValueSet对象。当使用此对象接收器进行多个异步调用时,使用此参数来标识触发此事件的异步调用的起始位置。

 

OBJRESULT

 

错误(名称/十进制/十六进制)

含义

wbemErrFailed

-2147217407

&H80041001

未指定错误

wbemErrOutOfMemory

-2147217402

&H80041006

没有足够的内存来完成操作。

wbemErrTransportFailure

-2147217387

&H80041015

出现网络错误,防止正常运行。

 

备注

 

异步回调允许非验证用户向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.inc中声明。

类型库

使用Wbemdisp.tlb。

DLL

需要Wbemdisp.dll。