Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

IWbemObjectAccess::ReadPropertyValue method

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 IWbemObjectAccess ReadPropertyValue(
  [in]  long lHandle,
  [in]  long lBufferSize,
  [out] long *plNumBytes,
  [out] byte *aData
);

Parameters

lHandle [in]

Integer that contains the handle identifying this property.

lBufferSize [in]

Integer that contains the buffer size.

plNumBytes [out]

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

aData [out]

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.

Return codeDescription
WBEM_E_BUFFER_TOO_SMALL

The supplied buffer was too small to read a string property.

WBEM_S_FALSE

The property was NULL.

WBEM_S_NO_ERROR

The method was successful.

 

Remarks

String data is returned as null-terminated WCHAR data.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Esscli.dll;
Fastprox.dll;
Wbemess.dll

See also

IWbemObjectAccess

 

 

Show:
© 2015 Microsoft