IPortableDeviceContent::Properties method

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

ppProperties [out]

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.

Return codeDescription
S_OK

The method succeeded.

E_POINTER

At least one of the required arguments was a NULL pointer.

 

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

Header

PortableDeviceApi.h

Library

PortableDeviceGUIDs.lib

See also

IPortableDeviceContent Interface
Retrieving Content-Object Properties
Retrieving Properties for Multiple Objects
Retrieving the Rendering Capabilities Supported by a Device
Setting Properties for a Single Object
Setting Properties for Multiple Objects
Transferring Content from the Device to a PC
Writing Content-Object Properties

 

 

Community Additions

ADD
Show: