Metodo IWbemObjectAccess::ReadPropertyValue (wbemcli.h)

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