Evento ISWbemSinkEvents::OnObjectReady
El evento OnObjectReady de un objeto SWbemSink se desencadena cuando una operación asincrónica devuelve un objeto. Use este evento para procesar objetos desde llamadas asincrónicas, como SWbemObject.InstancesAsync_ o SWbemServices.ExecQueryAsync. OnObjectReady devuelve un objeto SWbemObject cada vez hasta que se completa la enumeración.
Para obtener una explicación de esta sintaxis, consulte Convenciones de documentación para la API de scripting.
Sintaxis
SWbemSink.OnObjectReady( _
ByVal objWbemObject, _
ByVal objWbemAsyncContext _
)
Parámetros
-
objWbemObject
-
Objeto SWbemObject. Esto es similar a lo que devuelve el equivalente sincrónico de la llamada asincrónica que desencadena este evento. Por ejemplo, una llamada al método SWbemServices.GetAsync devuelve un objeto SWbemObject en el parámetro objWbemObject del evento OnObjectReady del objeto SWbemSink, que se pasa como parámetro objWbemObject de la llamada original. El mismo objeto SWbemObject se puede obtener mediante una llamada sincrónica equivalente a SWbemServices.Get.
-
objWbemAsyncContext
-
Un objeto SWbemNamedValueSet que se pasa a la llamada asincrónica original. Use este parámetro para identificar el origen de la llamada asincrónica que desencadena este evento cuando se realizan varias llamadas asincrónicas mediante este receptor de objetos.
Valor devuelto
Este evento no devuelve un valor.
Códigos de error
Después de completar el evento OnObjectReady, el objeto Err puede contener uno de los códigos de error siguientes.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Error no especificado.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
No hay suficiente memoria para completar la operación.
-
wbemErrTransportFailure - 2147749909 (0x80041015)
-
Se ha producido un error de red que impide el funcionamiento normal.
Comentarios
Una devolución de llamada asincrónica permite a un usuario no autenticado proporcionar datos al receptor. Esto supone riesgos de seguridad para los scripts y las aplicaciones. Para eliminar los riesgos, use la comunicación semisincrónica o la comunicación sincrónica. Para más información, consulte Llamada a un método.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| IDL |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSinkEvents |