Metodo IWbemObjectAccess::ReadPropertyValue (wbemcli.h)

Articolo
03/13/2024

Il metodo ReadPropertyValue restituisce un numero specificato di byte di una proprietà associata a un handle di proprietà. Utilizzare questo metodo per leggere il valore di una proprietà che contiene una stringa o per leggere una proprietà che contiene un valore diverso da 32 (DWORD) o 64 bit (QWORD).

Sintassi

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

Parametri

[in] lHandle

Intero contenente l'handle che identifica questa proprietà.

[in] lBufferSize

Intero contenente le dimensioni del buffer.

[out] plNumBytes

Puntatore a un numero intero utilizzato per restituire il numero di byte letti.

[out] aData

Puntatore a una matrice utilizzata per restituire i dati della proprietà.

Valore restituito

Questo metodo restituisce WBEM_S_NO_ERROR in caso di esito positivo; in caso contrario, questo metodo restituisce un valore HRESULT con uno dei valori seguenti.

Commenti

I dati stringa vengono restituiti come dati WCHAR con terminazione Null.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)
Libreria	Wbemuuid.lib
DLL	Esscli.dll; Fastprox.dll; Wbemess.dll

Vedi anche

IWbemObjectAccess

Condividi tramite