Méthode IWbemQualifierSet ::GetNames (wbemcli.h)

La méthode IWbemQualifierSet ::GetNames récupère les noms de tous les qualificateurs disponibles à partir de l’objet ou de la propriété actuel. En fonction de la valeur de filtre de IFlags, cette méthode récupère également les noms de certains qualificateurs.

Vous pouvez accéder à ces qualificateurs par nom, en utilisant IWbemQualifierSet ::Get pour chaque nom. Il ne s’agit pas d’une erreur pour qu’un objet donné ait zéro qualificateur, de sorte que le nombre de chaînes dans pstrNames au retour peut être égal à 0, même si WBEM_S_NO_ERROR retourne.

Syntaxe

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Paramètres

[in] lFlags

Une des constantes suivantes.

0 (zéro)

Retourne le nom de tous les qualificateurs.

WBEM_FLAG_LOCAL_ONLY

Retourne uniquement les noms des qualificateurs propres à la propriété ou à l’objet actuel. Si le jeu de qualificateurs actuel fait référence à une propriété, retournez uniquement les qualificateurs spécifiques à la propriété (y compris les remplacements), et non ceux propagés à partir de la définition de classe. Si le jeu de qualificateurs actuel fait référence à un instance, retournez uniquement les noms de qualificateurs spécifiques à instance. Si le jeu de qualificateurs actuel fait référence à une classe, retourne uniquement les qualificateurs spécifiques à la classe dérivée.

WBEM_FLAG_PROPAGATED_ONLY

Retourne uniquement les noms des qualificateurs propagés à partir d’un autre objet. Par exemple, si le jeu de qualificateurs actuel fait référence à une propriété, retournez uniquement les qualificateurs propagés à cette propriété à partir de la définition de classe, et non ceux de la propriété elle-même. Si le jeu de qualificateurs actuel fait référence à un instance, retournez uniquement les qualificateurs propagés à partir de la définition de classe. Si le jeu de qualificateurs actuel fait référence à une classe, retournez uniquement les noms de qualificateurs hérités des classes parentes.

[out] pNames

Un nouveau SAFEARRAY qui contient les noms demandés est créé.

Dans tous les cas où aucune erreur n’est retournée, un nouveau tableau est créé et pstrNames est défini pour pointer vers celui-ci. Cela se produit même si le tableau obtenu n’a aucun élément. En cas d’erreur, un nouveau SAFEARRAY n’est pas retourné.

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

Pour obtenir un exemple d’utilisation de SAFEARRAYde BSTR, consultez Récupération d’une partie d’une instance WMI.

Configuration requise

Voir aussi

IWbemQualifierSet

IWbemQualifierSet ::BeginEnumeration

IWbemQualifierSet ::Get