IPortableDeviceValues::SetKeyValue method

The SetKeyValue method adds a new REFPROPERTYKEY value (type VT_UNKNOWN) or overwrites an existing one.

Syntax


HRESULT SetKeyValue(
  [in] REFPROPERTYKEY key,
  [in] REFPROPERTYKEY Value
);

Parameters

key [in]

A REFPROPERTYKEY that specifies the item to create or overwrite.

Value [in]

A REFPROPERTYKEY that specifies the new value.

Return value

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

Return codeDescription
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

PortableDeviceTypes.h

Library

PortableDeviceGUIDs.lib

See also

Adding a Resource to an Object
IPortableDeviceValues Interface
IPortableDeviceValues::GetKeyValue

 

 

Community Additions

ADD
Show: