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

Artigo
03/21/2023
2 minutos para o fim da leitura

O método IWbemRefresher::Refresh atualiza todos os objetos atualizáveis, enumeradores e atualizadores aninhados. O Atualizador do 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

Máscara de bits 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 menor tempo possível. Usar os métodos IWbemObjectAccess e 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 uma atualização 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 quando a Atualização for chamada.

Exemplos

O exemplo de código a seguir descreve como implementar a Atualização.

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


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