IPortableDeviceContent::Properties method (portabledeviceapi.h)

The Properties method retrieves the interface that is required to get or set properties on an object on the device.

Syntax

HRESULT Properties(
  [out] IPortableDeviceProperties **ppProperties
);

Parameters

[out] ppProperties

Address of a variable that receives a pointer to an IPortableDeviceProperties interface that is used to get or set object properties. The caller must release this interface when it is done with it.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

The retrieved interface is not specific to a particular object on the device; it is specific only to the device. You must specify the ID of the object you want when requesting or setting properties.

Examples

For an example of how to use this method, see Setting Properties for a Single Object.

Requirements

See also

IPortableDeviceContent Interface

Retrieving Content-Object Properties

Retrieving Properties for Multiple Objects

Retrieving the Rendering Capabilities Supported by a Device

Setting Properties for Multiple Objects

Setting Properties for a Single Object

Transferring Content from the Device to a PC

Writing Content-Object Properties