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

Article
08/27/2023

La méthode IWbemHiPerfProvider::CreateRefresher crée un actualiseur. L’actualisation retournée sera utilisée dans les appels suivants à IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject et IWbemHiPerfProvider::StopRefreshing.

Note Si un fournisseur n’implémente pas cette méthode, il doit retourner WBEM_E_PROVIDER_NOT_CAPABLE. Un fournisseur doit implémenter cette méthode pour prendre en charge les opérations d’actualisation.

Syntaxe

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

Paramètres

[in] pNamespace

Pointeur IWbemServices vers Windows Management, qui peut traiter toute requête effectuée par le fournisseur. Le fournisseur doit appeler AddRef sur ce pointeur s’il veut rappeler Windows Management pendant son exécution.

[in] lFlags

Réservé. Ce paramètre doit être égal à 0 (zéro).

[out] ppRefresher

Pointeur pour contenir la référence à l’implémentation du fournisseur de l’interface IWbemRefresher .

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Remarques

Le fournisseur doit fournir sa propre implémentation de l’interface IWbemRefresher . WMI peut demander plusieurs actualisations, chacun d’eux étant utilisé pour ses propres opérations d’actualisation.

Lorsque vous relâchez un actualiseur, le fournisseur doit propre tous les objets actualisables ou énumérateurs qui ont été ajoutés à l’actualisation.

Exemples

L’exemple de code suivant décrit comment implémenter 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;

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemprov.h (include Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Wmiprvsd.dll