Partager via

GetPropertyQualifierSet, fonction

  • Article

Récupère le jeu de qualificateurs pour une propriété particulière.

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 GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Paramètres

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

ptr
[in] Pointeur vers une instance IWbemClassObject.

wszMethod
[in] Nom de la propriété. wszProperty doit pointer vers un LPCWSTR valide.

ppQualSet
[out] Reçoit le pointeur d’interface qui autorise l’accès aux qualificateurs de la propriété. ppQualSet ne peut pas avoir la valeur null. Si une erreur se produit, un nouvel objet n’est pas retourné et le pointeur est défini sur la valeur null.

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_FAILED 0x80041001 Il y a eu une défaillance générale.
WBEM_E_NOT_FOUND 0x80041002 La méthode spécifiée n’existe pas.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire n'est pas suffisante pour terminer cette opération.
WBEM_E_INVALID_PARAMETER 0x80041008 Un paramètre est null.
WBEM_E_SYSTEM_PROPERTY 0x80041030 La fonction tente d’obtenir des qualificateurs d’une propriété système.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction wrappe un appel à la méthode IWbemClassObject::GetPropertyQualifierSet.

Un appel à cette fonction est pris en charge uniquement si l’objet actuel est une définition de classe CIM. La manipulation de méthode n’est pas disponible pour les pointeurs IWbemClassObject qui pointent vers des instances CIM.

Étant donné que chaque méthode peut avoir ses propres qualificateurs, le pointeur IWbemQualifierSet permet à l’appelant d’ajouter, de modifier et de supprimer ces qualificateurs.

Étant donné que les propriétés système n’ont pas de qualificateurs, la fonction retourne WBEM_E_SYSTEM_PROPERTY si vous tentez d’obtenir un pointeur IWbemQualifierSet pour une propriété système.

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