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

OnCompleted Event

Previous pageReturn to chapter overviewNext page

描述

 

异步调用完成时触发SWbemSink对象的OnCompleted事件。此事件向客户端应用程序指示异步操作的结果,并在异步调用失败时提供错误信息。

 

PowerBASIC 语法

 

METHOD OnCompleted ( _

BYVAL iHResult AS LONG, _

BYVAL objWbemErrorObject AS ISWbemObject, _

BYVAL objWbemAsyncContext AS ISWbemNamedValueSet _

)

 

参数

 

iHResult

 

完成的异步方法的HRESULT。HRESULT与从等效的用于WMI的COM API方法调用返回的值相同。检查该值以确定异步调用是否成功。如果异步调用成功,则此参数包含WBEM_S_NO_ERROR(0)。如果异步调用失败,则此参数包含错误代码。

 

objWbemErrorObject

 

异步方法失败时包含SWbemLastError对象。

 

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。