Méthode IWbemObjectAccess ::GetPropertyHandle (wbemcli.h)

Article
03/03/2024

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

Share via