IPortableDeviceValues::GetBufferValue

banner art

The GetBufferValue method retrieves a byte array value (type VT_VECTOR | VT_UI1) specified by a key.

Syntax

  HRESULT GetBufferValue(
  REFPROPERTYKEY  key,
  BYTE**  ppValue,
  DWORD*  pcbValue
);

Parameters

key

[in] A REFPROPERTYKEY key that specifies the item to retrieve.

ppValue

[out] Pointer to the retrieved BYTE* value. The caller is responsible for freeing the memory by calling CoTaskMemFree.

pcbValue

[out] Pointer to the size of ppValue, in bytes.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
DISP_E_TYPEMISMATCH	The property specified by key is not a BYTE* type.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	The property specified by key is not in the collection.

Requirements

Header: Defined in PortableDeviceTypes.h

Library: PortableDeviceGUIDs.lib

See Also

Previous

Additional resources