IPortableDeviceValues::GetIPortableDevicePropVariantCollectionValue method

The GetIPortableDevicePropVariantCollectionValue method retrieves an IPortableDevicePropVariantCollection value (type VT_UNKNOWN) specified by a key.

Syntax

HRESULT GetIPortableDevicePropVariantCollectionValue(
  [in]  REFPROPERTYKEY                       key,
  [out] IPortableDevicePropVariantCollection **ppValue
);

Parameters

key [in]

A REFPROPERTYKEY key that specifies the item to retrieve.

ppValue [out]

Address of a variable that receives a pointer to the retrieved IPortableDevicePropVariantCollection interface. The caller is responsible for calling Release on the retrieved interface.

Return value

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 an IPortableDevicePropVariantCollection interface.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	The property specified by key is not in the collection.

Requirements

Requirement	Value
Header	PortableDeviceTypes.h
Library	PortableDeviceGUIDs.lib

See also

IPortableDeviceValues Interface

IPortableDeviceValues::SetIPortableDevicePropVariantCollectionValue