IPortableDeviceValues::GetBufferValue

  • Article

banner art

Previous Next

IPortableDeviceValues::GetBufferValue

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 Next