Compartilhar via


Evento ISWbemSinkEvents::OnCompleted

O evento OnCompleted de um objeto SWbemSink é disparado quando uma chamada assíncrona for 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 falhar.

Para conferir uma explicação dessa sintaxe, consulte Convenções de documentação para a API de Script.

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 valor retornado de uma chamada de método equivalente da API COM para 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 falhar.

objWbemAsyncContext

Isso é 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.

Retornar valor

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)

Não há memória suficiente 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 a 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