IPortableDeviceValues::SetIPortableDeviceKeyCollectionValue

banner art

Previous Next

IPortableDeviceValues::SetIPortableDeviceKeyCollectionValue

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

Syntax

  HRESULT SetIPortableDeviceKeyCollectionValue(
  REFPROPERTYKEY  key,
  IPortableDeviceKeyCollection*  pValue
);

Parameters

key

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

pValue

[in]  Pointer to an IPortableDeviceKeyCollection interface that specifies the new value. The SDK copies a reference to the submitted interface and calls AddRef on it.

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