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 |