ISWbemSinkEvents::OnObjectReady 事件
當非同步作業傳回物件時,會觸發SWbemSink物件的OnObjectReady事件。 使用此事件來處理非同步呼叫的物件,例如 SWbemObject.InstancesAsync_ 或 SWbemServices.ExecQueryAsync。 OnObjectReady 會在每次列舉完成之前傳回一個 SWbemObject 。
如需此語法的說明,請參閱 腳本 API 的檔慣例。
語法
SWbemSink.OnObjectReady( _
ByVal objWbemObject, _
ByVal objWbemAsyncContext _
)
參數
-
objWbemObject
-
SWbemObject物件。 這類似于觸發此事件之非同步呼叫的同步對等專案所傳回的內容。 例如,對SWbemServices.GetAsync方法的呼叫會傳回原始呼叫之OnObjectReady物件的ObjWbemObject 參數中的 SWbemObject參數,該事件會傳遞為原始呼叫的objWbemObject參數。 您可以使用對 SWbemServices.Get的對等同步呼叫來取得相同的SWbemObject物件。
-
objWbemAsyncCoNtext
-
傳遞至原始非同步呼叫的 SWbemNamedValueSet 物件。 使用此參數來識別使用這個物件接收進行多個非同步呼叫時,觸發此事件的非同步呼叫來源。
傳回值
這個事件不會傳回值。
錯誤碼
完成 OnObjectReady 事件之後, Err 物件可能會包含下列其中一個錯誤碼。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未指定的錯誤。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
記憶體不足,無法完成作業。
-
wbemErrTransportFailure - 2147749909 (0x80041015)
-
發生網路錯誤,防止正常作業。
備註
非同步回呼可讓未驗證的使用者將資料提供給接收。 這對您的腳本和應用程式造成安全性風險。 若要消除風險,請使用半同步通訊或同步通訊。 如需詳細資訊,請參閱 呼叫方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
Idl |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSinkEvents |