Partager via

Get, fonction

  • Article

Récupère la valeur de propriété spécifiée si elle existe.

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 Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Paramètres

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

ptr
[in] Pointeur vers une instance IWbemClassObject.

wszName
[in] Nom de la propriété.

lFlags
[in] Réservée. Ce paramètre doit être 0.

pVal
[out] Si la fonction réussit, contient la valeur de la propriété wszName. L’argument pval est attribué au type et à la valeur corrects du qualificateur.

pvtType
[out] Si la fonction réussit, contient une constante de type CIM qui indique le type de propriété. Sa valeur peut également être null.

plFlavor
[out] Si la fonction réussit, reçoit des informations sur l’origine de la propriété. Sa valeur peut être null, ou l’une des constantes WBEM_FLAVOR_TYPE suivantes définies dans le fichier d’en-tête WbemCli.h :

Constant Valeur Description
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 La propriété est une propriété système standard.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 Pour une classe : la propriété est héritée de la classe parente.
Pour une instance : la propriété, héritée de la classe parente, n’a pas été modifiée par l’instance.
WBEM_FLAVOR_ORIGIN_LOCAL 0 Pour une classe : la propriété appartient à la classe dérivée.
Pour une instance : la propriété est modifiée par l’instance. Autrement dit, une valeur a été fournie ou un qualificateur a été ajouté ou modifié.

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_INVALID_PARAMETER 0x80041008 Un ou plusieurs paramètres ne sont pas valides.
WBEM_E_NOT_FOUND 0x80041002 La propriété spécifiée est introuvable.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire n'est pas suffisante pour terminer cette opération.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

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

La fonction Get peut également retourner les propriétés système.

L’argument pVal est attribué au type et à la valeur corrects du qualificateur et de la fonction VariantInit COM.

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