IPortableDeviceValues::GetIPortableDeviceKeyCollectionValue method

The GetIPortableDeviceKeyCollectionValue method retrieves an IPortableDeviceKeyCollection value (type VT_UNKNOWN) specified by a key.

Syntax

HRESULT GetIPortableDeviceKeyCollectionValue(
  [in]  REFPROPERTYKEY               key,
  [out] IPortableDeviceKeyCollection **ppValue
);

key [in]: A REFPROPERTYKEY key that specifies the item to retrieve.
ppValue [out]: Pointer to the retrieved IPortableDeviceKeyCollection interface pointer. The caller is responsible for calling Release on the retrieved interface.

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

For an example of how to use this method, see Retrieving Supported Service Events.

Requirement	Value
Header	PortableDeviceTypes.h
Library	PortableDeviceGUIDs.lib