Evento ISWbemSinkEvents::OnCompleted

O evento OnCompleted de um objeto SWbemSink é disparado quando uma chamada assíncrona é concluída. Esse evento indica ao aplicativo cliente, o resultado de uma operação assíncrona e fornece informações de erro quando a chamada assíncrona falha.

Para obter uma explicação dessa sintaxe, consulte As Convenções de Documento para a API de Scripts.

Sintaxe

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

Parâmetros

iHResult

O HRESULT do método assíncrono concluído. O HRESULT é o mesmo que o valor retornado de uma API COM equivalente para a chamada de método WMI. Verifique esse valor para determinar se a chamada assíncrona foi ou não bem-sucedida. Se a chamada assíncrona for bem-sucedida, esse parâmetro conterá WBEM_S_NO_ERROR (0). Se a chamada assíncrona falhar, esse parâmetro conterá um código de erro.

objWbemErrorObject

Contém um objeto SWbemLastError quando o método assíncrono falha.

objWbemAsyncContext

Este é um objeto SWbemNamedValueSet que é passado para a chamada assíncrona original. Use esse parâmetro para identificar a origem da chamada assíncrona que dispara esse evento quando várias chamadas assíncronas são feitas usando esse coletor de objeto.

Valor retornado

Esse evento não retorna um valor.

Códigos do Erro

Após a conclusão do evento OnCompleted , o objeto Err pode conter um dos códigos de erro abaixo.

wbemErrFailed - 2147749889 (0x80041001)

Erro não especificado.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Memória insuficiente para concluir a operação.

wbemErrTransportFailure - 2147749909 (0x80041015)

Erro de rede, impedindo a operação normal.

Comentários

Um retorno de chamada assíncrono permite que um usuário não autenticado forneça dados ao coletor. Isso representa riscos de segurança para seus scripts e aplicativos. Para eliminar os riscos, use comunicação semissíncrona ou síncrona. Para obter mais informações, consulte Chamar um método.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents