// Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// \n
// Files are managed by the <code>ContentAccess::CManager</code> class in the content 
// access framework. 
// <hr>
// Some agents may choose to store content files inside their server private directories. For example:
// \private\<process SID>\protectedfile.ext
// If an agent wishes to publish the existence of its private directory, it should fill in the name of 
// the private directory (its SecureID of the process) in the \c opaque_data section of the agents ECOM resource file. 
// CAF will map the path to one based on the agent name so that it's human-readable. For example:
// \private\<agent_name>\protectedfile.ext
// <hr>
// The <code>ContentAccess::CManager::DeleteFileL()</code> allows a client to delete a specified file managed by a DRM agent. 
// The agent responsible for the content can display a dialog to confirm that 
// the user wants to delete the file. This is particularly important if the content still has valid rights.
// The agent implementation must decide whether to delete the rights or only the content.
// TFileName filename;
// // create a manager object
// CManager* manager = CManager::NewL();
// // Use the manager to delete a file
// // CAF will ask the agent who actually owns the file to delete it.
// TInt result = manager->DeleteFile(filename);
// <hr>
// <code>ContentAccess::CManager::CopyFile()</code> allows a user to make a copy of the file. For example, the user may wish 
// to make a copy of the file on removable media. When copying content managed by a DRM agent, the agent will only copy the 
// content, it will not copy the rights.
// TInt result = manager->CopyFile(source, destination);
// <hr>
// <code>ContentAccess::CManager::RenameFile()</code> allows a user to move or rename a file. 
// For example, the user may wish to move the file to removable media. 
// TInt result = manager->RenameFile(oldFilename, newFilename);
// <hr>
// <code>ContentAccess::CManager::MkDir()</code> allows a user to create a directory.
// TInt result = manager->MkDir(fullpath);
// <hr>
// <code>ContentAccess::CManager::MkDirAll()</code> allows a user to create a directory. 
// If one or more of the sub-directories do not exist they will be created too.
// TInt result = manager->MkDirAll(fullpath);
// <hr>
// <code>ContentAccess::CManager::RmDir()</code> allows a user to remove a directory. 
// TInt result = manager->RmDir(fullpath);
// <hr>
// There a three variations of the <code>ContentAccess::CManager::GetDir()</code> function. They each allow a client
// to list the contents of an agent's private directory.
// As mentioned earlier it is optional for agents to provide this information.
// CDir *aDir;
// TInt result = manager->GetDir(aName, aEntryAttMask, aEntrySortKey, aDir);
// <hr>
// The CAF Apparc recognizer provides a MIME type that is a combination of the file MIME type and
// the content within the file. In some circumstances, such as forwarding DRM content to another 
// device, it will be important to make sure the content is sent with the correct MIME type.
// Using the <code>""</code> empty string <code>UniqueId</code> allows an application to determine the MIME type of the file.
// TBuf <256> aMimeType;
// TInt result = manager->GetStringAttribute(EMimeType, aMimeType, TVirtualPathPtr(aURI,KNullDesC16()));
// <hr>
// The <code>CManager</code> API allows applications to retrieve attributes or string attributes from a content object
// <hr>
// 
//

/**
 @page CAFManageFiles Managing files with the Content Access Framework
 - @ref CAFPrivateDirectories
 - @ref Deleteing
 - @ref Copying
 - @ref Moving
 - @ref MkDir
 - @ref MkDirAll
 - @ref RemoveDir
 - @ref GetDir
 - @ref GetRealMimeType
 - @ref ManagerGetAttribute
 @section CAFPrivateDirectories Agents using Private directories
 @code
 @endcode
 See @ref CAA_Configuration.
 @code
 @endcode
 @section Deleteing Deleting a File
 @code
 @endcode
 @section Copying Copying a file
 @code
 @endcode
 @section Moving Move or Rename a file
 @code
 @endcode
 @section MkDir Creating a Directory
 @code
 @endcode
 @section MkDirAll Creating all directories
 @code
 @endcode
 @section RemoveDir Removing a Directory
 @code
 @endcode
 @section GetDir List the contents of a directory
 @code
 @endcode
 @section GetRealMimeType Find out the real MIME type of the file
 @code
 @endcode
 @section ManagerGetAttribute Get the attributes of the Content object
 as described in @ref ContentAttributes.
*/