Evento ISWbemSinkEvents::OnProgress

O evento OnProgress do SWbemSink é disparado quando uma chamada assíncrona retorna o status de uma chamada que está em andamento. Se os eventos, instâncias ou classes forem produzidos de um provedor que dá suporte a atualizações de status, você poderá colocar código nesse evento para fornecer comentários aos usuários sobre o status de uma operação assíncrona. Você deve definir o parâmetro iFlags da chamada assíncrona para wbemFlagSendStatus (128/0x80) se quiser receber atualizações de status, caso contrário, esse evento não será disparado.

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

Sintaxe

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

Parâmetros

iUpperBound

Inteiro que descreve o número total de tarefas a serem concluídas.

iCurrent

Item atual que está sendo processado.

strMessage

Mensagem que descreve o status da tarefa atual.

objWbemAsyncContext

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 OnProgress , 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

O evento OnProgress é disparado quando uma chamada assíncrona retorna o status de uma chamada que está em andamento. Se os eventos, instâncias ou classes forem produzidos de um provedor que dá suporte a atualizações de status, você poderá colocar código nesse evento para fornecer comentários aos usuários sobre o status de uma operação assíncrona.

Observação

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 semi-sí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

Confira também

SWbemSink