ISWbemSinkEvents::OnObjectReady 事件
当异步操作返回对象时,将触发 SWbemSink 对象的 OnObjectReady 事件。 使用此事件处理来自异步调用的对象,例如 SWbemObject.InstancesAsync_ 或 SWbemServices.ExecQueryAsync。 OnObjectReady 每次返回一个 SWbemObject,直至枚举完成。
有关此语法的说明,请参阅脚本 API 的文档约定。
语法
SWbemSink.OnObjectReady( _
ByVal objWbemObject, _
ByVal objWbemAsyncContext _
)
parameters
-
objWbemObject
-
一个 SWbemObject 对象。 这类似于触发此事件的异步调用的同步等效项返回的内容。 例如,调用 SWbemServices.GetAsync 方法将在 SWbemSink 对象的 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 |