Compartir a través de


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
Wbemdisp.h
IDL
Wbemdisp.idl
Archivo DLL
Wbemdisp.dll
CLSID
CLSID_SWbemSink
IID
IID_ISWbemSinkEvents

Consulte también

SWbemSink