IWbemObjectAccess::ReadPropertyValue method (wbemcli.h)

The ReadPropertyValue method returns a specified number of bytes of a property associated with a property handle. Use this method to read the value of a property that contains a string or to read a property that contains a value that is not 32 (DWORD) or 64 (QWORD) bits long.

Syntax

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

Parameters

[in] lHandle

Integer that contains the handle identifying this property.

[in] lBufferSize

Integer that contains the buffer size.

[out] plNumBytes

Pointer to an integer used to return the number of bytes read.

[out] aData

Pointer to an array used to return the property data.

Return value

This method returns WBEM_S_NO_ERROR if successful; otherwise, this method returns an HRESULT with one of the following values.

Remarks

String data is returned as null-terminated WCHAR data.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; Wbemess.dll

See also

IWbemObjectAccess