共用方式為


ISWbemSinkEvents::OnProgress 事件

當非同步呼叫傳回進行中的撥號狀態時,就會觸發SWbemSinkOnProgress事件。 如果事件、實例或類別是從支援狀態更新的提供者產生,您可以在此事件中放置程式碼,為使用者提供非同步作業狀態的意見反應。 如果您想要接收狀態更新,您必須將非同步呼叫的 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