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

Artigo
08/27/2023

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