Edit

IPortableDeviceValues::GetIPortableDeviceKeyCollectionValue method

  • Article

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

Syntax

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

Parameters

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.

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

Examples

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

Requirements

Requirement Value
Header
PortableDeviceTypes.h
Library
PortableDeviceGUIDs.lib

See also

IPortableDeviceValues Interface

IPortableDeviceValues::SetIPortableDeviceKeyCollectionValue

Retrieving Supported Service Events

Retrieving Supported Service Methods