MetaDataGetURIPropByID Interface Reference

Gets a property of a resource identified by a UPnP id. More...

---

Detailed Description

Gets a property of a resource identified by a UPnP id.

Path: /metadata/geturiprop_byid

Parameters:

[in]	id	The UPnP id of the resource.
[in]	propname	The property name being set. Has to conform to standard upnp properties (including the xml namespace prefix). For example: upnp:rating upnp:author etc.
[in]	apply_recursion	(optional) if set to 1, then will include ancestors' properties if this resource does not have this property. Ancestor in this case is as defined by the TVersity media library.

Returns:

An XML documnt with the response. The XML also has the URI of the resource. If the resource does not have this property, returns a "failure" status.

Remarks:

1. This API does not work for sub-properties (such as res@resolution) or for multi-valued properties (such as res).

2. The metadata API cannot be used to get properties extracted from the media itself, only values previously set using the metadata API.

Examples:

	http://localhost:<port>/metadata/geturiprop_byid?id=0/4/549/550&propname=upnp:rating

	<response status="success" message="">
		<resultset>
			<result uri="file://c:/users/mambo/downloads/videos" propname="upnp:rating" propvalue="clean">
		</resultset>
	</response>