Méthode IWbemObjectAccess ::GetPropertyHandle (wbemcli.h)
La méthode GetPropertyHandle retourne un handle unique qui identifie une propriété. Vous pouvez utiliser ce descripteur pour identifier les propriétés lors de l’utilisation des méthodes IWbemObjectAccess pour lire ou écrire des valeurs de propriété.
Syntaxe
HRESULT GetPropertyHandle(
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE *pType,
[out] long *plHandle
);
Paramètres
[in] wszPropertyName
Constante, chaîne terminée par un caractère Null de caractères Unicode 16 bits qui contient le nom de la propriété.
[out] pType
Pointeur vers un CIMTYPE utilisé pour renvoyer le type CIM de la propriété.
[out] plHandle
Pointeur vers un entier utilisé pour retourner le handle de propriété.
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
Les handles peuvent être récupérés pour tous les types de données autres que CIM_OBJECT et CIM_ARRAY. Les descripteurs retournés fonctionnent sur toutes les instances d’une classe.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
Plateforme cible | Windows |
En-tête | wbemcli.h (include Wbemidl.h) |
Bibliothèque | Wbemuuid.lib |
DLL | Esscli.dll ; Fastprox.dll ; Wbemess.dll |