Partager via


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

Voir aussi

IWbemObjectAccess