Allows extended synchronous calls to the agent Objects are passed in and out using serialization

Allows extended asynchronous calls to the agent. Objects can be passed in and out using serialization. NB: No assumption should be made about the scope of the descriptor passed to aInputBuffer for asynchronous IPC.

Make a copy of the content file (eg to removable media) belonging to this agent

Access to the agents private directory is permitted at the agents discretion.

Make a copy of the content file (eg to removable media) belonging to this agent using a file handle

Access to the agents private directory is permitted at the agents discretion.

Delete a file belonging to this agent

The agent implementation may delete rights that were associated with the content at the same time. If an agent does delete rights at the same time as the content it should display a confirmation dialog that makes it clear to the user the rights they paid for will be also deleted.

Execution will be blocked until any dialog displayed is complete. Applications can request to disable the agents user interface using the SetProperty() command

Access to the agents private directory is permitted at the agents discretion.

View information associated with a single content object

This call blocks execution and only returns once the display is dismissed by the user.

View information associated with a single content object in a file specified by file handle. Can be used when the source file is in the client's private directory.

This call blocks execution and only returns once the display is dismissed by the user.

Allow the agent to display management information for users to manage any settings or other information stored by the agent

The scope of this information is left to the agent implementation but it is expected that a DRM agent will display the state of all DRM rights objects (pending, available, expired, orphaned) and allow users to delete rights that are no longer required.

Get an attribute from a content object

Get a content's attribute from a file specified by file handle. Can be used when the source file is in the client's private directory.

Get a set of attributes from a content object

Get a content's set of attributes from a file specified by file handle. Can be used when the source file is in the client's private directory.

Gets a filtered list of a directory's contents.

The bitmask determines which file and directory entry types should be listed. The sort key determines the order in which they are listed.

This function can be used to list the contents of the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Agents can just return KErrCANotSupported if they do not wish to publish their private directory. Alternatively they can just populate the CDir object with the entries they wish to show.

Gets a filtered list of the directory and file entries contained in a directory and a list of the directory entries only

The bitmask determines which file and directory entry types should be listed in aFileList. The contents of the second list, aDirList are not affected by the bitmask; it returns all directory entries contained in directory aName. The sort key determines the order in which both lists are sorted.

This function can be used to list the contents of the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Agents can just return KErrCANotSupported if they do not wish to publish their private directory. Alternatively they can just populate the CDir object with the entries they wish to show.

Gets a filtered list of a directory's contents by UID

The aUidType parameter determines which file entry types should be listed. The sort key determines the order in which they are listed.

This function can be used to list the contents of the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Agents can just return KErrCANotSupported if they do not wish to publish their private directory. Alternatively they can just populate the CDir object with the entries they wish to show.

Get text string attributes or meta-data from the file

Get a content's text string attribute from a file specified by file handle. Can be used when the source file is in the client's private directory.

Used to obtain a set of string attributes

Get a content's set of string attributes from a file specified by file handle. Can be used when the source file is in the client's private directory.

Identifies whether or not the file at the given URI is to be handled by this agent.

The agent should perform the mimimum possible processing to make the recognition process as fast as possible. It should avoid opening the file whenever possible.

The agent should leave only if a temporary or permanent condition prevents it from knowing whether it can detect the content's type.

Identifies whether or not the file is handled by this agent.

The agent should look at the name of the file first to try and avoid the need to read from the file.

The agent should leave only if a temporary or permanent condition prevents it from knowing whether it can detect the content's type.

Create a directory

This function can be used to create a directory within in the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Create all directories in the given path if they do not exist

This function can be used to create directories within in the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Notify the caller when the status of a DRM protected content object changes. NB: No assumption should be made about the scope of the descriptor passed to aURI for asynchronous IPC.

Prepare the HTTP request headers required to download files that may be required for this agent.

Determines whether the file is recognized by this agent. If it is the agent will fill in the file mime type and content mime type.

The agent should attempt to recognized the file in an efficient manner It should avoid opening the file to provide the best performance.

The agent should leave only if a temporary or permanent condition prevents it from detecting content's type.

The agent SHOULD NOT perform any API policing on this API since it will be called from within the Apparc server's process.

If a file is recognized, the file mime type should always be set to the correct value. For the content mime type there are three special cases:

Rename a directory

This function can be used to rename a directory from within the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Rename or move the content file (eg to removable media) belonging to this agent

Access to the agent private directories is permitted at the agents discretion.

Remove a directory

This function can be used to remove a directory from within the agent's private directory. Access to the agents private directory is permitted at the agents discretion.

Allows an application to request the modification of a property within the agent. The agent may or may not permit the property to be changed