Méthode IWbemConfigureRefresher ::AddObjectByTemplate (wbemcli.h)

Avec la méthode IWbemConfigureRefresher ::AddObjectByTemplate, vous pouvez ajouter un objet que vous souhaitez actualiser à un actualiseur en spécifiant un modèle de instance IWbemClassObject. Utilisez cette méthode lorsqu’il est difficile de construire un chemin d’accès d’objet pour un objet à ajouter à un actualiseur.

Note Les propriétés clés de l’objet instance doivent être renseignées avant que vous puissiez appeler la méthode AddObjectByTemplate.

 

Syntaxe

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Paramètres

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] pTemplate

Pointeur vers un objet IWbemClassObject qui contient le modèle instance.

[in] lFlags

Masque de bits des indicateurs qui modifient le comportement de cette méthode. Si ce paramètre est défini sur WBEM_FLAG_USE_AMENDED_QUALIFIERS, le instance retourné contient des qualificateurs localisés s’ils sont disponibles.

[in] pContext

Généralement NULL ; sinon, pointeur vers un objet IWbemContext requis par un ou plusieurs fournisseurs de classes dynamiques. Les valeurs de l’objet de contexte doivent être spécifiées dans la documentation du fournisseur spécifique. Pour plus d’informations sur ce paramètre, consultez Effectuer des appels à WMI.

[out] ppRefreshable

Pointeur pour contenir la référence à un objet IWbemClassObject, qui contiendra l’objet instance actualisable. Le client doit appeler Release sur l’objet retourné quand il n’est plus nécessaire.

[out] plId

Pointeur vers un entier retourné par le fournisseur qui identifie de manière unique cet objet actualisable.

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 instance fourni doit spécifier un objet valide, qui est fourni par le fournisseur de High-Performance. L’objet retourné ne doit pas être modifié par le client pendant qu’une opération d’actualisation est en cours. L’identificateur retourné peut être utilisé par la fonction Remove pour supprimer l’objet .

Il n’est pas nécessaire que l’utilisateur supprime explicitement les objets ajoutés. Le client doit appeler Release sur l’objet retourné quand il n’est plus nécessaire.

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

Voir aussi

Accès aux données de performances en C++

IWbemConfigureRefresher

Faire d’un fournisseur d’instance un fournisseur de haute performance

Fournisseur de compteurs de performances