Evento ISWbemSinkEvents::OnProgress

El evento OnProgress de SWbemSink se desencadena cuando una llamada asincrónica devuelve el estado de una llamada que está en curso. Si los eventos, instancias o clases se generan a partir de un proveedor que admite actualizaciones de estado, puede colocar código en este evento para proporcionar a los usuarios comentarios sobre el estado de una operación asincrónica. Debe establecer el parámetro iFlags de la llamada asincrónica como wbemFlagSendStatus (128/0x80) si quiere recibir actualizaciones de estado; de lo contrario, este evento no se desencadena.

Para obtener una explicación de esta sintaxis, consulte Convenciones de documentación para la API de scripting.

Sintaxis

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

Parámetros

iUpperBound

Entero que describe el número total de tareas que se van a completar.

iCurrent

Elemento actual que se está procesando.

strMessage

Mensaje que describe el estado de la tarea actual.

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 OnProgress, 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

El evento OnProgress se desencadena cuando una llamada asincrónica devuelve el estado de una llamada que está en curso. Si los eventos, instancias o clases se generan a partir de un proveedor que admite actualizaciones de estado, puede colocar código en este evento para proporcionar a los usuarios comentarios sobre el estado de una operación asincrónica.

Nota:

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 una comunicación semisincrónica o sincrónica. Para obtener 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