Método IWbemObjectAccess::ReadPropertyValue (wbemcli.h)

El método ReadPropertyValue devuelve un número especificado de bytes de una propiedad asociada a un identificador de propiedad. Utilice este método para leer el valor de una propiedad que contiene una cadena o para leer una propiedad que contenga un valor que no sea de 32 bits (DWORD) o 64 bits (QWORD) de longitud.

Sintaxis

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

Parámetros

[in] lHandle

Entero que contiene el identificador que identifica esta propiedad.

[in] lBufferSize

Entero que contiene el tamaño del búfer.

[out] plNumBytes

Puntero a un entero utilizado para devolver el número de bytes leídos.

[out] aData

Puntero a una matriz utilizada para devolver los datos de propiedad.

Valor devuelto

Este método devuelve WBEM_S_NO_ERROR si se ejecuta correctamente; de lo contrario, este método devuelve un VALOR HRESULT con uno de los valores siguientes.

Comentarios

Los datos de cadena se devuelven como datos WCHAR terminados en null.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Esscli.dll; Fastprox.dll; Wbemess.dll

Consulte también

IWbemObjectAccess