ISWbemSinkEvents：：OnProgress 事件

當非同步呼叫傳回進行中的撥號狀態時，就會觸發SWbemSink的OnProgress事件。 如果事件、實例或類別是從支援狀態更新的提供者產生，您可以在此事件中放置程式碼，為使用者提供非同步作業狀態的意見反應。 如果您想要接收狀態更新，您必須將非同步呼叫的 iFlags 參數設定為 wbemFlagSendStatus (128/0x80) ，否則不會觸發此事件。

如需此語法的說明，請參閱 腳本 API 的檔慣例。

語法

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

參數

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