ISWbemSinkEvents::OnProgress 事件

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

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

parameters

iUpperBound

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

iCurrent

当前正在处理的项。

strMessage

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

objWbemAsyncContext

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

返回值

此事件不返回值。

错误代码

OnProgress 事件完成后，Err 对象可能包含以下错误代码之一。

wbemErrFailed - 2147749889 (0x80041001)

错误。

wbemErrOutOfMemory - 2147749894 (0x80041006)

内存不足，无法完成此操作。

wbemErrTransportFailure - 2147749909 (0x80041015)

出现网络错误，无法正常操作。

备注

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

注意

异步回调允许未经身份验证的用户向接收器提供数据。 这会给脚本和应用程序带来安全风险。 为消除风险，请使用半同步或同步通信。 有关详细信息，请参阅调用方法。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

另请参阅

SWbemSink