diff -r 000000000000 -r 2c201484c85f contentmgmt/contentaccessfwfordrm/engineering/dox/HowToManageFiles.dox
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/contentmgmt/contentaccessfwfordrm/engineering/dox/HowToManageFiles.dox Wed Jul 08 11:25:26 2009 +0100
@@ -0,0 +1,119 @@
+// 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 "Symbian Foundation License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/sfl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// \n
+// Files are managed by the ContentAccess::CManager
class in the content
+// access framework.
+//
ContentAccess::CManager::DeleteFileL()
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);
+// ContentAccess::CManager::CopyFile()
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);
+// ContentAccess::CManager::RenameFile()
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);
+// ContentAccess::CManager::MkDir()
allows a user to create a directory.
+// TInt result = manager->MkDir(fullpath);
+// ContentAccess::CManager::MkDirAll()
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);
+// ContentAccess::CManager::RmDir()
allows a user to remove a directory.
+// TInt result = manager->RmDir(fullpath);
+// ContentAccess::CManager::GetDir()
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);
+// ""
empty string UniqueId
allows an application to determine the MIME type of the file.
+// TBuf <256> aMimeType;
+// TInt result = manager->GetStringAttribute(EMimeType, aMimeType, TVirtualPathPtr(aURI,KNullDesC16()));
+// CManager
API allows applications to retrieve attributes or string attributes from a content object
+//