IWbemObjectAccess ::ReadPropertyValue, méthode (wbemcli.h)

Article
03/03/2024

La méthode ReadPropertyValue retourne un nombre spécifié d’octets d’une propriété associée à un handle de propriété. Utilisez cette méthode pour lire la valeur d’une propriété qui contient une chaîne ou pour lire une propriété qui contient une valeur qui n’est pas 32 (DWORD) ou 64 bits (QWORD).

Syntaxe

HRESULT ReadPropertyValue(
  [in]  long lHandle,
  [in]  long lBufferSize,
  [out] long *plNumBytes,
  [out] byte *aData
);

Paramètres

[in] lHandle

Entier qui contient le handle identifiant cette propriété.

[in] lBufferSize

Entier qui contient la taille de la mémoire tampon.

[out] plNumBytes

Pointeur vers un entier utilisé pour renvoyer le nombre d’octets lus.

[out] aData

Pointeur vers un tableau utilisé pour retourner les données de propriété.

Valeur retournée

Cette méthode retourne WBEM_S_NO_ERROR si elle réussit ; sinon, cette méthode retourne un HRESULT avec l’une des valeurs suivantes.

Remarques

Les données de chaîne sont retournées en tant que données WCHAR terminées par null.

Configuration requise

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 (inclure Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Esscli.dll ; Fastprox.dll ; Wbemess.dll

Voir aussi

IWbemObjectAccess

Partager via