Partager via

QualifierSet_GetNames, fonction

  • Article

Récupère les noms de tous les qualificateurs ou de certains qualificateurs qui sont disponibles à partir de la propriété ou de l’objet actuels.

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

HRESULT QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Paramètres

vFunc
[in] Ce paramètre est inutilisé.

ptr
[in] Pointeur vers une instance IWbemQualifierSet.

lFlags
[in] L’un des indicateurs ou valeurs suivants qui spécifient les noms à inclure dans l’énumération.

Constant Valeur Description
0 Retourne le nom de tous les qualificateurs.
WBEM_FLAG_LOCAL_ONLY 0x10 Retourne uniquement les noms des qualificateurs propres à la propriété ou à l’objet actuel.
Pour une propriété : retourne uniquement les qualificateurs propres à la propriété (y compris les remplacements), et non les qualificateurs propagés à partir de la définition de classe.
Pour une instance : retourne uniquement des noms de qualificateurs propres à l’instance.
Pour une classe : retourne uniquement les qualificateurs propres à la classe dérivée.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Retourne uniquement les noms des qualificateurs propagés à partir d’un autre objet.
Pour une propriété : retourne uniquement les qualificateurs propagés vers cette propriété à partir de la définition de classe, et non ceux de la propriété même.
Pour une instance : retourne uniquement les qualificateurs propagés à partir de la définition de classe.
Pour une classe : retourne uniquement les noms de qualificateurs hérités des classes parentes.

pstrNames
[out] Nouveau SAFEARRAY qui contient les noms demandés. Le tableau peut avoir 0 élément. Si une erreur se produit, aucun nouveau SAFEARRAY ne sera retourné.

Valeur retournée

Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :

Constant Valeur Description
WBEM_E_INVALID_PARAMETER 0x80041008 Un paramètre n'est pas valide.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire disponible est insuffisante pour commencer une nouvelle énumération.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction wrappe un appel à la méthode IWbemQualifierSet::GetNames.

Une fois que vous avez récupéré les noms des qualificateurs, vous pouvez accéder à chaque qualificateur par son nom, en appelant la fonction QualifierSet_Get.

Le fait qu’un objet donné ait zéro qualificateur ne constitue pas une erreur. Le nombre de chaînes dans pstrNames à son retour peut donc être de 0, même si la fonction retourne WBEM_S_NO_ERROR.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : WMINet_Utils.idl

Versions de .NET Framework : disponibles depuis la version 4.7.2

Voir aussi