Método IWbemRefresher::Refresh (wbemcli.h)

Artigo
08/27/2023

O método IWbemRefresher::Refresh atualiza todos os objetos atualizáveis, enumeradores e atualizadores aninhados. O Atualizador WMI chama essa função em resposta a uma solicitação de cliente para Atualizar.

Sintaxe

HRESULT Refresh(
  [in] long lFlags
);

Parâmetros

[in] lFlags

Bitmask de sinalizadores que modificam o comportamento desse método.

Se WBEM_FLAG_REFRESH_AUTO_RECONNECT for especificado e se a conexão for interrompida, o atualizador tentará se reconectar ao provedor automaticamente. Esse é o comportamento padrão para esse método.

Se você não quiser que o atualizador tente se reconectar ao provedor, especifique WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.

Comentários

Ao atualizar enumeradores e objetos, os provedores devem levar o mínimo de tempo possível. Usar os métodos IWbemObjectAccess e os identificadores de propriedade de cache para reutilização pode melhorar drasticamente o desempenho. Ao atualizar enumeradores, um provedor pode remover e instanciar novamente todos os objetos ou simplesmente remover e adicionar as instâncias alteradas. Cabe a você escolher a melhor abordagem. Em ambos os casos, as instâncias de cache podem melhorar o desempenho.

O provedor só deve acessar os objetos e enumeradores em um atualizador em resposta a uma chamada para IWbemRefresher::Refresh. No entanto, seria perfeitamente válido ter uma sondagem de thread em segundo plano para dados com os quais preencher esses objetos, para se preparar para quando Refresh for chamado.

Exemplos

O exemplo de código a seguir descreve como implementar Atualizar.

HRESULT CMyHiPerfProviderRefresher::Refresh(
/* [in] */long lFlags
)
{
  // Run through all the objects and update their
  // data.

  // Now run through the enumerators.
  // Empty the enumerator and refill it.
   

  return WBEM_S_NO_ERROR;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (include Wbemidl.h)
Biblioteca	Wbemuuid.lib