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 |
|
| IDL |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSinkEvents |