Evento ISWbemSinkEvents::OnCompleted

L'evento OnCompleted di un oggetto SWbemSink viene attivato quando viene completata una chiamata asincrona. Questo evento indica all'applicazione client, il risultato di un'operazione asincrona e fornisce informazioni sull'errore quando la chiamata asincrona ha esito negativo.

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

Sintassi

SWbemSink.OnCompleted( _
  ByVal iHResult, _
  ByVal objWbemErrorObject, _
  ByVal objWbemAsyncContext _
)

Parametri

iHResult

HRESULT del metodo asincrono completato. HRESULT corrisponde al valore restituito da una chiamata di metodo COM equivalente per la chiamata al metodo WMI . Controllare questo valore per determinare se la chiamata asincrona ha esito positivo. Se la chiamata asincrona ha esito positivo, questo parametro contiene WBEM_S_NO_ERROR (0). Se la chiamata asincrona ha esito negativo, questo parametro contiene un codice di errore.

objWbemErrorObject

Contiene un oggetto SWbemLastError quando il metodo asincrono ha esito negativo.

objWbemAsyncContext

Si tratta di un 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 OnCompleted , 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

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 la comunicazione semisynchrono o sincrona. 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