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

  • Article

La méthode IWbemConfigureRefresher ::AddObjectByPath ajoute un objet à un actualisation en spécifiant un chemin d’accès de l’objet.

Syntaxe

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Paramètres

[in] pNamespace

Un 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 doit rappeler dans Windows Management pendant son exécution.

[in] wszPath

Chaîne constante avec fin null de caractères Unicode 16 bits qui contient le chemin d’accès de l’objet que vous ajoutez à l’actualisation.

[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, les instance retournés contiennent 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 contient l’objet instance actualisable. Le client doit appeler Release sur l’objet retourné lorsqu’il n’est plus nécessaire.

[out] plId

Pointeur vers un entier retourné par le fournisseur qui identifie de manière unique l’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 chemin d’accès fourni doit spécifier un objet valide, qui est fourni par le fournisseur High-Performance. L’objet retourné ne doit pas être touché 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.

Note Il n’est pas nécessaire que l’utilisateur supprime explicitement les objets ajoutés. Le client doit appeler Release sur l’objet retourné lorsqu’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 (inclure 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