ISWbemSinkEvents::OnCompleted 事件
當非同步呼叫完成時,就會觸發SWbemSink物件的OnCompleted事件。 這個事件會向用戶端應用程式指出非同步作業的結果,並在非同步呼叫失敗時提供錯誤資訊。
如需此語法的說明,請參閱 腳本 API 的檔慣例。
語法
SWbemSink.OnCompleted( _
ByVal iHResult, _
ByVal objWbemErrorObject, _
ByVal objWbemAsyncContext _
)
參數
-
iHResult
-
已完成非同步方法的 HRESULT。 HRESULT 與從 WMI 方法呼叫的對等 COM API 傳回的值相同。 請檢查此值,以判斷非同步呼叫是否成功。 如果非同步呼叫成功,此參數會包含 WBEM_S_NO_ERROR (0) 。 如果非同步呼叫失敗,此參數會包含錯誤碼。
-
objWbemErrorObject
-
當非同步方法失敗時,會包含 SWbemLastError 物件。
-
objWbemAsyncCoNtext
-
這是傳遞至原始非同步呼叫的 SWbemNamedValueSet 物件。 使用此參數來識別使用這個物件接收進行多個非同步呼叫時,觸發此事件的非同步呼叫來源。
傳回值
這個事件不會傳回值。
錯誤碼
完成 OnCompleted 事件之後, Err 物件可能包含下列其中一個錯誤碼。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未指定的錯誤。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
記憶體不足,無法完成作業。
-
wbemErrTransportFailure - 2147749909 (0x80041015)
-
發生網路錯誤,防止正常作業。
備註
非同步回呼可讓未驗證的使用者將資料提供給接收。 這對您的腳本和應用程式造成安全性風險。 若要消除風險,請使用半同步或同步通訊。 如需詳細資訊,請參閱 呼叫方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
Idl |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSinkEvents |