IPortableDeviceValues::GetIPortableDeviceValuesCollectionValue method

The GetIPortableDeviceValuesCollectionValue method retrieves an IPortableDeviceValuesCollection value (type VT_UNKNOWN) specified by a key.

Syntax


HRESULT GetIPortableDeviceValuesCollectionValue(
  [in]  REFPROPERTYKEY                  key,
  [out] IPortableDeviceValuesCollection **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 IPortableDeviceValuesCollection 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 codeDescription
S_OK

The method succeeded.

DISP_E_TYPEMISMATCH

The property specified by key is not an IPortableDeviceValuesCollection 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 the Rendering Capabilities Supported by a Device.

Requirements

Header

PortableDeviceTypes.h

Library

PortableDeviceGUIDs.lib

See also

IPortableDeviceValues Interface
Retrieving the Rendering Capabilities Supported by a Device
SetIPortableDeviceValuesCollectionValue

 

 

Community Additions

ADD
Show: