Evento ISWbemSinkEvents::OnProgress

Articolo
06/13/2023

L'evento OnProgress di SWbemSink viene attivato quando una chiamata asincrona restituisce lo stato di una chiamata in corso. Se gli eventi, le istanze o le classi vengono generati da un provider che supporta gli aggiornamenti dello stato, è possibile inserire codice in questo evento per fornire agli utenti commenti e suggerimenti sullo stato di un'operazione asincrona. È necessario impostare il parametro iFlags della chiamata asincrona a wbemFlagSendStatus (128/0x80) se si desidera ricevere gli aggiornamenti dello stato, in caso contrario questo evento non viene attivato.

Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.

Sintassi

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

Parametri

iUpperBound: Intero che descrive il numero totale di attività da completare.
iCurrent: Elemento corrente in fase di elaborazione.
strMessage: Messaggio che descrive lo stato dell'attività corrente.
objWbemAsyncContext: Oggetto SWbemNamedValueSet passato alla chiamata asincrona originale. Usare questo parametro per identificare l'origine della chiamata asincrona che attiva questo evento quando vengono eseguite più chiamate asincrone usando questo sink di oggetti.

Valore restituito

Questo evento non restituisce un valore.

Codici di errore

Al termine dell'evento OnProgress , l'oggetto Err può contenere uno dei codici di errore seguenti.

wbemErrFailed - 2147749889 (0x80041001): Errore non specificato.
wbemErrOutOfMemory - 2147749894 (0x80041006): Memoria insufficiente per completare l'operazione.
wbemErrTransportFailure - 2147749909 (0x80041015): Si è verificato un errore di rete, impedendo la normale operazione.

Commenti

L'evento OnProgress viene attivato quando una chiamata asincrona restituisce lo stato di una chiamata in corso. Se gli eventi, le istanze o le classi vengono generati da un provider che supporta gli aggiornamenti dello stato, è possibile inserire codice in questo evento per fornire agli utenti commenti e suggerimenti sullo stato di un'operazione asincrona.

Nota

Un callback asincrono consente a un utente non autenticato di fornire dati al sink. Ciò comporta rischi di sicurezza per gli script e le applicazioni. Per eliminare i rischi, usare comunicazioni semi-sincrone o sincrone. Per altre informazioni, vedere Chiamata di un metodo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

Vedi anche

SWbemSink