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

OnProgress Event

Previous pageReturn to chapter overviewNext page

描述

 

当异步调用返回正在进行的调用状态时,触发SWbemSinkOnProgress事件。如果事件,实例或类是从支持状态更新的提供程序生成的,则可以在此事件中放置代码,以向用户提供有关异步操作状态的反馈。如果要接收状态更新,则必须将异步调用的iFlags参数设置为wbemFlagSendStatus(128 / &H80),否则不会触发此事件。

 

PowerBASIC 语法

 

METHOD OnProgress ( _

BYVAL iUpperBound AS LONG, _

BYVAL iCurrent AS LONG, _

BYVAL strMessage AS WSTRING, _

BYVAL objWbemAsyncContext AS ISWbemNamedValueSet _

)

 

参数

 

iUpperBound

 

描述完成任务总数的整数。

 

iCurrent

 

正在处理的当前项目。

 

strMessage

 

描述当前任务状态的消息。

 

objWbemAsyncContext

 

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

 

OBJRESULT

 

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

含义

wbemErrFailed

-2147217407

&H80041001

未指定错误

wbemErrOutOfMemory

-2147217402

&H80041006

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

wbemErrTransportFailure

-2147217387

&H80041015

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

 

备注

 

当异步调用返回正在进行的调用状态时,触发OnProgress事件。如果事件,实例或类是从支持状态更新的提供程序生成的,则可以在此事件中放置代码,以向用户反馈异步操作的状态。

 

注意异步回调允许未经身份验证的用户向宿提供数据。这对您的脚本和应用程序造成安全隐患。为了消除风险,请使用半异步或同步通信。有关详细信息,请参阅调用方法.

 

要求

 

客户

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