IPortableDeviceValues::SetBufferValue

  • Article

banner art

Previous Next

IPortableDeviceValues::SetBufferValue

The SetBufferValue method adds a new BYTE* value (type VT_VECTOR | VT_UI1) or overwrites an existing one.

Syntax

  HRESULT SetBufferValue(
  REFPROPERTYKEY  key,
  BYTE*  pValue,
  DWORD  cbValue
);

Parameters

key

[in]  A REFPROPERTYKEY that specifies the item to create or overwrite.

pValue

[in]  A BYTE* that contains the data to write to the item. The submitted buffer data is copied to the interface, so the caller can free this buffer after making this call.

cbValue

[in]  The size of the value pointed to by pValue, 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.

Remarks

If an existing value has the same key that is specified by the key parameter, it overwrites the existing value without any warning. The existing key memory is released appropriately.

Requirements

Header: Defined in PortableDeviceTypes.h

Library: PortableDeviceGUIDs.lib

See Also

Previous Next