Metodo IWbemHiPerfProvider::CreateRefresher (wbemprov.h)

Articolo
08/27/2023

Il metodo IWbemHiPerfProvider::CreateRefresher crea un refresher. L'aggiornamento restituito verrà usato nelle chiamate successive a IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject e IWbemHiPerfProvider::StopRefreshing.

Nota Se un provider non implementa questo metodo, deve restituire WBEM_E_PROVIDER_NOT_CAPABLE. Un provider deve implementare questo metodo per supportare le operazioni di aggiornamento.

Sintassi

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

Parametri

[in] pNamespace

Puntatore IWbemServices in Gestione Windows, che può gestire qualsiasi richiesta effettuata dal provider. Il provider deve chiamare AddRef su questo puntatore se verrà richiamato in Gestione Windows durante l'esecuzione.

[in] lFlags

Riservato. Questo parametro deve essere 0 (zero).

[out] ppRefresher

Puntatore per contenere il riferimento all'implementazione del provider dell'interfaccia IWbemRefresher .

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT.

Commenti

Il provider deve fornire la propria implementazione dell'interfaccia IWbemRefresher . È valido per WMI richiedere più aggiornamenti, ognuno dei quali verrà usato per le proprie operazioni di aggiornamento.

Quando si rilascia un aggiornamento, il provider deve pulire tutti gli oggetti o gli enumeratori aggiornabili aggiunti all'utilità di aggiornamento.

Esempio

Nell'esempio di codice seguente viene descritto come implementare 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;

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemprov.h (include Wbemidl.h)
Libreria	Wbemuuid.lib
DLL	Wmiprvsd.dll