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

La méthode IWbemConfigureRefresher ::AddEnum ajoute un énumérateur à l’actualisation demandée.

Syntaxe

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

Paramètres

[in] pNamespace

Pointeur IWbemServices vers Windows Management, qui peut traiter toute requête effectuée par le fournisseur. Si la méthode doit rappeler windows management pendant son exécution, le fournisseur doit appeler AddRef avec le pointeur pNamespace .

[in] wszClassName

Constante, chaîne terminée par un caractère Null de caractères Unicode 16 bits contenant le nom de la classe énumérée.

[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 instances retournées contiennent des qualificateurs localisés s’ils sont disponibles.

[in] pContext

Généralement NULL ; sinon, il s’agit d’un 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] ppEnum

Pointeur qui contient la référence à un objet IWbemHiPerfEnum , qui contiendra l’énumération. Le client doit appeler Release sur ce pointeur quand il n’est plus nécessaire.

[out] plId

Pointeur vers un entier retourné par le fournisseur qui identifie de manière unique l’énumération 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

Remarques

La classe fournie doit spécifier une classe valide, qui est fournie par le fournisseur High-Performance. Toutes les instances de l’énumérateur retourné peuvent être interrogées après les appels. À chaque appel à actualiser, le nombre d’instances dans l’énumérateur peut varier. Seules les instances du nom de classe spécifié sont retournées ; les sous-classes de la classe spécifiée ne sont pas énumérées, car l’énumération détaillée n’est pas prise en charge. L’énumérateur 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 . Notez qu’il n’est pas nécessaire que l’utilisateur supprime explicitement les énumérateurs ajoutés. Toutefois, le client doit appeler Release sur l’énumérateur retourné lorsqu’il n’est plus nécessaire.

Configuration requise

Voir aussi

IWbemConfigureRefresher