IWbemHiPerfProvider::CreateRefresher, méthode (wbemprov.h)

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 La gestion Windows, qui peut traiter n’importe quelle requête effectuée par le fournisseur. Le fournisseur doit appeler AddRef sur ce pointeur s’il va appeler 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 un HRESULT indiquant l’état de l’appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Notes

Le fournisseur doit fournir sa propre implémentation de l’interface IWbemRefresher . Il est valide pour WMI de demander plusieurs actualisations, chacune d’elles étant utilisée pour ses propres opérations d’actualisation.

Lorsque vous publiez un actualiseur, le fournisseur doit nettoyer tous les objets ou énumérateurs actualisables 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

Voir aussi

Développement d’un fournisseur WMI

IWbemHiPerfProvider

Création d’un fournisseur d’instances dans un fournisseur de High-Performance

Fournisseur de compteurs de performances

Écriture d’un fournisseur d’instances