IWbemRefresher ::Refresh, méthode (wbemcli.h)

Article
03/13/2024

La méthode IWbemRefresher ::Refresh met à jour tous les objets actualisables, énumérateurs et actualisateurs imbriqués. L’actualiseur WMI appelle cette fonction en réponse à une demande de client à Refresh.

Syntaxe

HRESULT Refresh(
  [in] long lFlags
);

Paramètres

[in] lFlags

Masque de bits des indicateurs qui modifient le comportement de cette méthode.

Si WBEM_FLAG_REFRESH_AUTO_RECONNECT est spécifié et si la connexion est interrompue, l’actualisation tente de se reconnecter automatiquement au fournisseur. Il s’agit du comportement par défaut pour cette méthode.

Si vous ne souhaitez pas que l’actualisation tente de se reconnecter au fournisseur, spécifiez WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT.

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

Lors de l’actualisation des énumérateurs et des objets, les fournisseurs doivent prendre le moins de temps possible. L’utilisation des méthodes IWbemObjectAccess et des descripteurs de propriétés de mise en cache à des fins de réutilisation peut améliorer considérablement les performances. Lors de la mise à jour des énumérateurs, un fournisseur peut supprimer et réinstancier tous les objets, ou simplement supprimer et ajouter les instances modifiées. C’est à vous de choisir la meilleure approche. Dans les deux cas, la mise en cache des instances peut améliorer les performances.

Le fournisseur doit uniquement accéder aux objets et énumérateurs dans un actualisateur en réponse à un appel à IWbemRefresher ::Refresh. Toutefois, il serait parfaitement valide d’avoir un thread d’arrière-plan interrogeant les données avec lesquelles remplir ces objets, afin de préparer le moment où Actualiser est appelé.

Exemples

L’exemple de code suivant décrit comment implémenter l’actualisation.

HRESULT CMyHiPerfProviderRefresher::Refresh(
/* [in] */long lFlags
)
{
  // Run through all the objects and update their
  // data.

  // Now run through the enumerators.
  // Empty the enumerator and refill it.
   

  return WBEM_S_NO_ERROR;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (include Wbemidl.h)
Bibliothèque	Wbemuuid.lib