Compartilhar via


Método IWbemHiPerfProvider::CreateRefresher (wbemprov.h)

O método IWbemHiPerfProvider::CreateRefresher cria uma atualização. O atualizador retornado será usado em chamadas subsequentes para IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject e IWbemHiPerfProvider::StopRefreshing.

Nota Se um provedor não implementar esse método, ele deverá retornar WBEM_E_PROVIDER_NOT_CAPABLE. Um provedor deve implementar esse método para dar suporte a operações de atualização.
 

Sintaxe

HRESULT CreateRefresher(
  [in]  IWbemServices  *pNamespace,
  [in]  long           lFlags,
  [out] IWbemRefresher **ppRefresher
);

Parâmetros

[in] pNamespace

Um ponteiro IWbemServices de volta para o Gerenciamento do Windows, que pode atender a qualquer solicitação feita pelo provedor. O provedor deverá chamar AddRef nesse ponteiro se ele for chamar novamente para o Gerenciamento do Windows durante sua execução.

[in] lFlags

Reservado. Esse parâmetro deve ser 0 (zero).

[out] ppRefresher

Ponteiro para manter a referência à implementação do provedor da interface IWbemRefresher .

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

O provedor deve fornecer sua própria implementação da interface IWbemRefresher . É válido que o WMI solicite várias atualizações, cada uma das quais será usada para suas próprias operações de atualização.

Quando você lança uma atualização, o provedor deve limpo todos os objetos ou enumeradores atualizáveis que foram adicionados ao atualizador.

Exemplos

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

HRESULT CHiPerfProvider::CreateRefresher(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */ long lFlags,
  /* [out] */ IWbemRefresher** ppRefresher
)
{
    // Allocate a new refresher
    //For Example:
    // CMyRefresher* pMyRefresher = new CMyRefresher();

    // Return the refresher to the ppRefresher
    // [out] parameter
    /*return pMyRefresher->QueryInterface(
     IID_IWbemRefresher, (void**) ppRefresher );*/
}

// Free memory resources.
// For Example:
//pNamespace->Release();
//ppRefresher->Release();
//delete[] pMyRefresher;

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemprov.h (inclua Wbemidl.h)
Biblioteca Wbemuuid.lib
DLL Wmiprvsd.dll

Confira também

Como desenvolver um provedor do WMI

IWbemHiPerfProvider

Transformar um provedor de instância em um provedor de alto desempenho

Provedor de Contadores de Desempenho

Escrever um provedor de instância