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

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

Voir aussi

IWbemObjectAccess