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.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
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
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| 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 Multiple Objects
Setting Properties for a Single Object