Evento ISWbemSinkEvents::OnProgress

O evento OnProgress de SWbemSink é disparado quando uma chamada assíncrona retorna o status de uma chamada que está em andamento. Se os eventos, as instâncias ou as classes forem produzidos em um provedor que dá suporte a atualizações status, você poderá colocar código nesse evento para fornecer aos usuários comentá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 status, caso contrário, esse evento não será disparado.

Para ver uma explicação dessa sintaxe, confira Convenções de documento para a API de script.

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.

Retornar valor

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)

Não há memória suficiente 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, as instâncias ou as classes forem produzidos em um provedor que dá suporte a atualizações status, você poderá colocar código nesse evento para dar aos usuários comentários sobre o status de uma operação assíncrona.

Requisitos

Confira também

SWbemSink