--- a/contentmgmt/contentaccessfwfordrm/engineering/dox/Examples.dox	Tue Jul 21 01:04:32 2009 +0100
+++ b/contentmgmt/contentaccessfwfordrm/engineering/dox/Examples.dox	Thu Sep 10 14:01:51 2009 +0300
@@ -1,367 +1,365 @@
-// 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:
-// Some of the examples below do not include fully comprehensive error checking. They are written this way to simplify the 
-// understanding of the basic steps involved. All errors should be handled appropriately in production code.
-// <b>Consumer API </b>
-// <b>Supplier API </b>
-// <hr>
-// This example function takes the URI of a file and displays the plaintext version of that content on screen.
-// If anything goes wrong, for instance the file does not exist or there are no valid rights
-// that will allow the file to be displayed, the function will just leave.
-// It's important to notice the call to <code>ContentAccess::CData::ExecuteIntent()</code>, this should always be called, even if you
-// think it's unlikely you will open DRM content.
-// class CContentViewer : public CBase
-// public:
-// static CContentViewer* NewL();
-// static CContentViewer* NewLC();
-// // Display given content.
-// void DisplayContent(const TDesC& aUri, TRequestStatus& aStatus)
-// TRAPD(err, DisplayContentL(aUri));
-// User::RequestComplete(aStatus, err);
-// private:
-// CContentViewer() : CBase() {}
-// ~CContentViewer() {} 
-// void DisplayContentL(const TDesC& aUri)
-// TInt size = 0;
-// TInt i = 0;
-// // Create a CContent object
-// // CAF will figure out the appropriate agent
-// CContent *content = CContent::NewLC(aUri);
-// // Create a CData object to read the content
-// // Tell the agent we are planning to display the content
-// CData *data = content->OpenContentLC(EDisplay);
-// // Don't need content object any more
-// CleanupStack::PopAndDestroy(content);
-// // get the size of the plaintext content
-// data->DataSizeL(size);
-// // Execute the intent, tell the agent that we plan to display the content
-// // It is at this point that any stateful rights will be decremented
-// data->ExecuteIntentL(EDisplay);
-// // read and display the file until we reach the end of the file
-// TBuf <128> buffer;		
-// while(i < size)
-// // read from the file
-// User::LeaveIfError(data->Read(buffer));
-// i += buffer.Length();
-// // display on screen
-// printf(buffer);
-// // finished with Data object
-// CleanupStack::PopAndDestroy(data);
-// <hr>
-// This example is the same as before except it attempts to obtain or wait for rights
-// to become available rather than just leaving if access to the content is restricted.
-// class CContentViewer : public CActive
-// public:
-// static CContentViewer* NewL();
-// static CContentViewer* NewLC();
-// // Display given content.
-// void DisplayContent(const TDesC& aUri, TRequestStatus& aStatus)
-// iUri = aUri;
-// iClientStatus = &aStatus;
-// iClientStatus = KRequestPending;
-// iCurrentState = EOpenFile;
-// // trigger our RunL
-// iStatus = KRequestPending;
-// SetActive();
-// User::RequestComplete(iStatus, KErrNone);
-// void RunL()
-// TInt err = iStatus.Int();
-// switch (iCurrentState)
-// case EOpenFile:
-// iContent = CContent::NewL(aUri);
-// TRAP(err, iData = iContent->OpenContentL(EDisplay));
-// iCurrentState = EReadAndDisplay;	// follow through...
-// case EReadAndDisplay:
-// if(err == KErrNone)
-// TRAP(err, DisplayFile());
-// iCurrentState = EFinished;
-// // tell client iStatus that we have finished
-// User::RequestComplete(*iClientStatus, err);
-// return;
-// else if(err == KErrCANoRights)
-// // we don't have rights so we need to wait for them
-// iCurrentState = EWaitingForRights;
-// // ask CAF to initiate download of rights
-// iContent->RequestRights(iStatus);
-// else if(err == KErrCAPendingRights)
-// // waiting for rights to arrive, expected any minute now
-// iCurrentState = EWaitingForRights;
-// // ask CAF to notify us when they arrive
-// iContent->NotifyStatusChange(ERightsAvailable , iStatus);
-// // wait for CAF to complete our request 
-// iLastError = err;
-// iStatus = KRequestPending;
-// SetActive();
-// break;
-// case EWaitingForRights:
-// if(ret == KErrNone)
-// // change the state to try and display content again
-// iCurrentState = EReadAndDisplay;
-// // trigger our RunL
-// iLastError = err;
-// iStatus = KRequestPending;
-// SetActive();
-// User::RequestComplete(iStatus, KErrNone);
-// else
-// // couldn't get rights, tell parent active object we're finished
-// User::RequestComplete(iClientStatus, err);
-// return;
-// break;
-// protected:		
-// void DoCancel()
-// if (iLastError == KErrCAPendingRights)
-// iContent->CancelNotifyStatusChange(iStatus);
-// else if (iLastError == KErrCANoRights)
-// iContent->CancelRequestRights(iStatus);
-// private:
-// CContentViewer() : CActive(EPriorityStandard)
-// CActiveScheduler::Add(this); 
-// ~CContentViewer() 
-// Cancel();
-// if (iData) delete iData; 
-// if (iContent) delete iContent;
-// // Display the content, if any error occurs then leave
-// void DisplayContentL();
-// TInt size = 0;
-// TInt i = 0;
-// TBuf <128> buffer;
-// // Execute the intent, tell the agent that we plan to display the content
-// // It is at this point that any stateful rights will be decremented
-// iData->ExecuteIntentL(EDisplay);
-// // get the size of the plaintext content
-// iData->DataSizeL(size);
-// // read and display the file until we reach the end of the file
-// while(i < size)
-// // read from the file
-// User::LeaveIfError(iData->Read(buffer));
-// i += buffer.Length();
-// // Display on screen
-// printf(buffer);
-// private:
-// enum TState
-// EOpenFile = 0,
-// EReadAndDisplay,
-// EWaitingForRights,
-// EFinished
-// CContent*	iContent;
-// CData* 		iData;
-// TDesC		iUri;
-// TState			iCurrentState;
-// TInt 			iLastError;
-// TRequestStatus*		iClientStatus;
-// <hr>
-// Some servers may wish to prevent access to DRM content by untrusted clients, even if
-// the server itself has DRM capability.
-// To achieve this the server should use the <code>ContentAccess::TIntent::EUnknown</code> intent when 
-// accessing content. Content files that are not DRM protected will still work normally, but
-// access to DRM protected content will be blocked.
-// // Tell the agent we have no idea what the application plans to do
-// CData *data = content->OpenContentL(EUnknown);
-// // Execute the intent, tell the agent that we have no idea what the content will be used for
-// data->ExecuteIntentL(EUnknown);
-// <hr>
-// When reading from a particular content object within a file the application must supply
-// the \c UniqueId of the object when calling <code>ContentAccess::CContent::OpenContentL()</code>.
-// void DisplayTextFileL(const TDesC& aUri)
-// TInt size = 0;
-// TInt i = 0;
-// TBuf <128> buffer;
-// // Create a CContent object
-// // CAF will figure out the appropriate agent
-// CContent *content = CContent::NewLC(aUri);
-// // Find the objects in the file with MIME type image/jpeg
-// RStreamablePtrArray<CEmbeddedObject> myArray;
-// CleanupClosePushL(myArray);
-// User::LeaveIfError(content->Search(myArray, _L("image/jpeg"), EFalse));
-// // Get the virtual path of the first image/jpeg we find
-// TVirtualPathPtr picture = *myArray[0];
-// // Tell the agent to open the object with the given UniqueId
-// CData *data = content->OpenContentLC(EDisplay, picture.UniqueId());
-// // Don't need content object or array any more
-// CleanupStack::PopAndDestroy(2);	// content, myArray
-// // get the size of the plaintext content
-// data->DataSizeL(size);
-// // Execute the intent, tell the agent that we plan to display the content
-// // It is at this point that any stateful rights will be decremented
-// data->ExecuteIntentL(EDisplay);
-// // read and display the file until we reach the end of the file
-// while(i < size)
-// // read from the file
-// User::LeaveIfError(data->Read(buffer));
-// i += buffer.Length();
-// // display on screen
-// printf(buffer);
-// // finished with Data object
-// CleanupStack::PopAndDestroy(data);
-// <hr>
-// This example shows how a messaging application that has just received
-// a message attachment from a mail server can offer the attachment
-// to CAF for processing. The output files will be saved in <code>C:\\files\\</code>.
-// void CMyApp::ReceiveMessageAttachment(const TDesC8& aContentType, const TDesC8& aMessageAttachment)
-// // Create supplier object
-// CSupplier* supplier = CSupplier::NewLC();
-// // Tell the agent where we would like the output files to be written
-// supplier->SetOutputDirectoryL(_L("C:\\files"));
-// // Check if CAF can import this attachment we just received
-// if(supplier->IsImportSupported(aContentType))
-// ProcessAttachmentL(supplier, aContentType, aMessageAttachment);	
-// else
-// // just save the message to a file in its current form
-// RFile theFile;
-// theFile.Open(iFs, "myFile");
-// theFile.Write(aMessageAttachment);
-// theFile.Close();
-// // Add the file to the list of attachments
-// AddAttachment("myFile");
-// void CMyApp::ProcessAttachmentL(CSupplier* aSupplier, const TDesC8& aContentType, const TDesC8& aMessageAttachment)
-// TInt err = KErrNone;
-// TBuf <128> buf;
-// // Create meta-data array
-// CMetaDataArray* metaDataArray = new (ELeave) CMetaDataArray();
-// CleanupStack::PushL(metaDataArray);
-// // Add any useful information we can think of....
-// // Obviously these would not be hardcoded this way in a real import
-// metaDataArray->AddL(_L("Content Type"), _L("application/vnd.oma.drm.dm"));
-// metaDataArray->AddL(_L("Content Length"), _L("1201"));
-// metaDataArray->AddL(_L("X-Oma-Drm-Separate-Delivery"), _L("6"));
-// // Create the import object
-// CImportFile* import = aSupplier->ImportFileL(aContentType, *metaDataArray, _L("myfile"));
-// CleanupStack::PushL(import);
-// // import the attachment
-// err = import->WriteData(aMessageText);
-// // tell CAF (and hence the agent) it's now got the entire file
-// if (err == KErrNone)
-// err = import->WriteDataComplete();
-// if (err == KErrNone)
-// // Look at the output of the import operation
-// for(TInt i = 0; i < import->OutputFileCountL(); i++)
-// // for this example only add content output files
-// // (absorb any rights in the original attachment 'silently')
-// if(import->OutputFilesL(i).OutputType == EContent)
-// // Add file to list of attachments for this message
-// AddAttachment(import->OutputFilesL(i).FileName());
-// // Error handling
-// if (err != KErrNone)
-// if (err == KErrNotReady)	
-// DisplayErrorMsg("Agent not ready for import");
-// else if (err == KErrCACorruptContent)
-// DisplayErrorMsg("Content data is corrupt");
-// else
-// DisplayErrorMsg("Unexpected error: %d", err);
-// // Finished
-// CleanupStack::PopAndDestroy(2);		// metaDataArray, import
-// <hr>
-// This example shows how a messaging application that has just received
-// a message attachment from a mail server can offer the attachment
-// to CAF for processing and store the file in its own private directory.
-// void CMyApp::ReceiveMessageAttachment(const TDesC8& aContentType, const TDesC8& aMessageAttachment)
-// // Create supplier object
-// CSupplier* supplier = CSupplier::NewLC();
-// // Check if CAF can import this attachment we just received
-// if(supplier->IsImportSupported(aContentType))
-// ProcessAttachmentL(supplier, aContentType, aMessageAttachment);	
-// else
-// // just save the message to a file in its current form
-// RFile theFile;
-// theFile.Open(iFs, "myFile");
-// theFile.Write(aMessageAttachment);
-// theFile.Close();
-// // Add the file to the list of attachments
-// AddAttachment("myFile");
-// void CMyApp::ProcessAttachmentL(CSupplier* aSupplier, const TDesC8& aContentType, const TDesC8& aMessageAttachment)
-// TInt err = KErrNone;
-// TBuf <128> buf;
-// TBuf <4> fileExtension;
-// _LIT(KOutputFileName, "\\private\\12345678\\outputfile.");
-// TFileName fileName(KOutputFileExtension);
-// RFile file;
-// // Create meta-data array
-// CMetaDataArray* metaDataArray = CMetaDataArray::NewLC();
-// // Add any useful information we can think of....
-// // Obviously these would not be hardcoded this way in a real import
-// metaDataArray->AddL(_L("Content Type"), _L("application/vnd.oma.drm.dm"));
-// metaDataArray->AddL(_L("Content Length"), _L("1201"));
-// metaDataArray->AddL(_L("X-Oma-Drm-Separate-Delivery"), _L("6"));
-// // Create the import object, no suggested file name implies the application will supply output files
-// CImportFile* import = aSupplier->ImportFileL(aContentType, *metaDataArray);
-// CleanupStack::PushL(import);
-// // Start importing the attachment
-// // (if the agent needs one or more output files, continue looping until 
-// // the agent finishes the previous)
-// TInt err = import->WriteData(aMessageText);
-// while(err == KErrCANewFileHandleRequired)
-// import->GetSuggestedOutputFileExtension(fileExtension);
-// filName.Append(fileExtension);
-// User::LeaveIfError(file.Open(iFs, fileName));
-// err = import->ContinueWithNewOutputFile(file);
-// file.Close();
-// if (err == KErrNone)
-// // Complete the import process
-// err = import->WriteDataComplete();
-// while(err == KErrCANewFileHandleRequired)
-// import->GetSuggestedOutputFileExtension(fileExtension);
-// filName.Append(fileExtension);
-// User::LeaveIfError(file.Open(iFs, fileName));
-// err = import->ContinueWithNewOutputFile(file);
-// file.Close();
-// if (err == KErrNone)
-// // Look at the output of the import operation
-// for(TInt i = 0; i < import->OutputFileCountL(); i++)
-// // for this example only add content output files
-// // (absorb any rights in the original attachment 'silently')
-// if(import->OutputFilesL(i).OutputType == EContent)
-// // Add file to list of attachments for this message
-// AddAttachment(import->OutputFilesL(i).FileName());
-// // Error handling
-// if (err != KErrNone)
-// if (err == KErrNotReady)	
-// DisplayErrorMsg("Agent not ready for import");
-// else if (err == KErrCACorruptContent)
-// DisplayErrorMsg("Content data is corrupt");
-// else
-// DisplayErrorMsg("Unexpected error: %d", err);
-// // Finshed
-// CleanupStack::PopAndDestroy(2);		// metaDataArray, import
-// 
-//
-
-
-
-/**
- @page CAFExamples Example source code using CAF
- - @ref ExampleRead1
- - @ref ExampleReadWithErrCheck
- - @ref PlayingUnprotectedOnly 
- - @ref MultipleContentExample
- - @ref ExampleSupplier1
- - @ref ExampleSupplier2
- @section ExampleRead1 Reading from a file, no error checking
- @code
- @endcode
- @section ExampleReadWithErrCheck Reading from a file, with error checking
- @code
- @endcode
- @section PlayingUnprotectedOnly Preventing access to DRM content
- @code
- @endcode
- @section MultipleContentExample File containing several content objects
- @code
- @endcode
- @section ExampleSupplier1 Importing a content file, agent provides output files
- @code
- @endcode
- @section ExampleSupplier2 Importing a content file, application provides output files
- @code
- @endcode
-*/
+// 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:
+// Some of the examples below do not include fully comprehensive error checking. They are written this way to simplify the 
+// understanding of the basic steps involved. All errors should be handled appropriately in production code.
+// <b>Consumer API </b>
+// <b>Supplier API </b>
+// <hr>
+// This example function takes the URI of a file and displays the plaintext version of that content on screen.
+// If anything goes wrong, for instance the file does not exist or there are no valid rights
+// that will allow the file to be displayed, the function will just leave.
+// It's important to notice the call to <code>ContentAccess::CData::ExecuteIntent()</code>, this should always be called, even if you
+// think it's unlikely you will open DRM content.
+// class CContentViewer : public CBase
+// public:
+// static CContentViewer* NewL();
+// static CContentViewer* NewLC();
+// // Display given content.
+// void DisplayContent(const TDesC& aUri, TRequestStatus& aStatus)
+// TRAPD(err, DisplayContentL(aUri));
+// User::RequestComplete(aStatus, err);
+// private:
+// CContentViewer() : CBase() {}
+// ~CContentViewer() {} 
+// void DisplayContentL(const TDesC& aUri)
+// TInt size = 0;
+// TInt i = 0;
+// // Create a CContent object
+// // CAF will figure out the appropriate agent
+// CContent *content = CContent::NewLC(aUri);
+// // Create a CData object to read the content
+// // Tell the agent we are planning to display the content
+// CData *data = content->OpenContentLC(EDisplay);
+// // Don't need content object any more
+// CleanupStack::PopAndDestroy(content);
+// // get the size of the plaintext content
+// data->DataSizeL(size);
+// // Execute the intent, tell the agent that we plan to display the content
+// // It is at this point that any stateful rights will be decremented
+// data->ExecuteIntentL(EDisplay);
+// // read and display the file until we reach the end of the file
+// TBuf <128> buffer;		
+// while(i < size)
+// // read from the file
+// User::LeaveIfError(data->Read(buffer));
+// i += buffer.Length();
+// // display on screen
+// printf(buffer);
+// // finished with Data object
+// CleanupStack::PopAndDestroy(data);
+// <hr>
+// This example is the same as before except it attempts to obtain or wait for rights
+// to become available rather than just leaving if access to the content is restricted.
+// class CContentViewer : public CActive
+// public:
+// static CContentViewer* NewL();
+// static CContentViewer* NewLC();
+// // Display given content.
+// void DisplayContent(const TDesC& aUri, TRequestStatus& aStatus)
+// iUri = aUri;
+// iClientStatus = &aStatus;
+// iClientStatus = KRequestPending;
+// iCurrentState = EOpenFile;
+// // trigger our RunL
+// iStatus = KRequestPending;
+// SetActive();
+// User::RequestComplete(iStatus, KErrNone);
+// void RunL()
+// TInt err = iStatus.Int();
+// switch (iCurrentState)
+// case EOpenFile:
+// iContent = CContent::NewL(aUri);
+// TRAP(err, iData = iContent->OpenContentL(EDisplay));
+// iCurrentState = EReadAndDisplay;	// follow through...
+// case EReadAndDisplay:
+// if(err == KErrNone)
+// TRAP(err, DisplayFile());
+// iCurrentState = EFinished;
+// // tell client iStatus that we have finished
+// User::RequestComplete(*iClientStatus, err);
+// return;
+// else if(err == KErrCANoRights)
+// // we don't have rights so we need to wait for them
+// iCurrentState = EWaitingForRights;
+// // ask CAF to initiate download of rights
+// iContent->RequestRights(iStatus);
+// else if(err == KErrCAPendingRights)
+// // waiting for rights to arrive, expected any minute now
+// iCurrentState = EWaitingForRights;
+// // ask CAF to notify us when they arrive
+// iContent->NotifyStatusChange(ERightsAvailable , iStatus);
+// // wait for CAF to complete our request 
+// iLastError = err;
+// iStatus = KRequestPending;
+// SetActive();
+// break;
+// case EWaitingForRights:
+// if(ret == KErrNone)
+// // change the state to try and display content again
+// iCurrentState = EReadAndDisplay;
+// // trigger our RunL
+// iLastError = err;
+// iStatus = KRequestPending;
+// SetActive();
+// User::RequestComplete(iStatus, KErrNone);
+// else
+// // couldn't get rights, tell parent active object we're finished
+// User::RequestComplete(iClientStatus, err);
+// return;
+// break;
+// protected:		
+// void DoCancel()
+// if (iLastError == KErrCAPendingRights)
+// iContent->CancelNotifyStatusChange(iStatus);
+// else if (iLastError == KErrCANoRights)
+// iContent->CancelRequestRights(iStatus);
+// private:
+// CContentViewer() : CActive(EPriorityStandard)
+// CActiveScheduler::Add(this); 
+// ~CContentViewer() 
+// Cancel();
+// if (iData) delete iData; 
+// if (iContent) delete iContent;
+// // Display the content, if any error occurs then leave
+// void DisplayContentL();
+// TInt size = 0;
+// TInt i = 0;
+// TBuf <128> buffer;
+// // Execute the intent, tell the agent that we plan to display the content
+// // It is at this point that any stateful rights will be decremented
+// iData->ExecuteIntentL(EDisplay);
+// // get the size of the plaintext content
+// iData->DataSizeL(size);
+// // read and display the file until we reach the end of the file
+// while(i < size)
+// // read from the file
+// User::LeaveIfError(iData->Read(buffer));
+// i += buffer.Length();
+// // Display on screen
+// printf(buffer);
+// private:
+// enum TState
+// EOpenFile = 0,
+// EReadAndDisplay,
+// EWaitingForRights,
+// EFinished
+// CContent*	iContent;
+// CData* 		iData;
+// TDesC		iUri;
+// TState			iCurrentState;
+// TInt 			iLastError;
+// TRequestStatus*		iClientStatus;
+// <hr>
+// Some servers may wish to prevent access to DRM content by untrusted clients, even if
+// the server itself has DRM capability.
+// To achieve this the server should use the <code>ContentAccess::TIntent::EUnknown</code> intent when 
+// accessing content. Content files that are not DRM protected will still work normally, but
+// access to DRM protected content will be blocked.
+// // Tell the agent we have no idea what the application plans to do
+// CData *data = content->OpenContentL(EUnknown);
+// // Execute the intent, tell the agent that we have no idea what the content will be used for
+// data->ExecuteIntentL(EUnknown);
+// <hr>
+// When reading from a particular content object within a file the application must supply
+// the \c UniqueId of the object when calling <code>ContentAccess::CContent::OpenContentL()</code>.
+// void DisplayTextFileL(const TDesC& aUri)
+// TInt size = 0;
+// TInt i = 0;
+// TBuf <128> buffer;
+// // Create a CContent object
+// // CAF will figure out the appropriate agent
+// CContent *content = CContent::NewLC(aUri);
+// // Find the objects in the file with MIME type image/jpeg
+// RStreamablePtrArray<CEmbeddedObject> myArray;
+// CleanupClosePushL(myArray);
+// User::LeaveIfError(content->Search(myArray, _L("image/jpeg"), EFalse));
+// // Get the virtual path of the first image/jpeg we find
+// TVirtualPathPtr picture = *myArray[0];
+// // Tell the agent to open the object with the given UniqueId
+// CData *data = content->OpenContentLC(EDisplay, picture.UniqueId());
+// // Don't need content object or array any more
+// CleanupStack::PopAndDestroy(2);	// content, myArray
+// // get the size of the plaintext content
+// data->DataSizeL(size);
+// // Execute the intent, tell the agent that we plan to display the content
+// // It is at this point that any stateful rights will be decremented
+// data->ExecuteIntentL(EDisplay);
+// // read and display the file until we reach the end of the file
+// while(i < size)
+// // read from the file
+// User::LeaveIfError(data->Read(buffer));
+// i += buffer.Length();
+// // display on screen
+// printf(buffer);
+// // finished with Data object
+// CleanupStack::PopAndDestroy(data);
+// <hr>
+// This example shows how a messaging application that has just received
+// a message attachment from a mail server can offer the attachment
+// to CAF for processing. The output files will be saved in <code>C:\\files\\</code>.
+// void CMyApp::ReceiveMessageAttachment(const TDesC8& aContentType, const TDesC8& aMessageAttachment)
+// // Create supplier object
+// CSupplier* supplier = CSupplier::NewLC();
+// // Tell the agent where we would like the output files to be written
+// supplier->SetOutputDirectoryL(_L("C:\\files"));
+// // Check if CAF can import this attachment we just received
+// if(supplier->IsImportSupported(aContentType))
+// ProcessAttachmentL(supplier, aContentType, aMessageAttachment);	
+// else
+// // just save the message to a file in its current form
+// RFile theFile;
+// theFile.Open(iFs, "myFile");
+// theFile.Write(aMessageAttachment);
+// theFile.Close();
+// // Add the file to the list of attachments
+// AddAttachment("myFile");
+// void CMyApp::ProcessAttachmentL(CSupplier* aSupplier, const TDesC8& aContentType, const TDesC8& aMessageAttachment)
+// TInt err = KErrNone;
+// TBuf <128> buf;
+// // Create meta-data array
+// CMetaDataArray* metaDataArray = new (ELeave) CMetaDataArray();
+// CleanupStack::PushL(metaDataArray);
+// // Add any useful information we can think of....
+// // Obviously these would not be hardcoded this way in a real import
+// metaDataArray->AddL(_L("Content Type"), _L("application/vnd.oma.drm.dm"));
+// metaDataArray->AddL(_L("Content Length"), _L("1201"));
+// metaDataArray->AddL(_L("X-Oma-Drm-Separate-Delivery"), _L("6"));
+// // Create the import object
+// CImportFile* import = aSupplier->ImportFileL(aContentType, *metaDataArray, _L("myfile"));
+// CleanupStack::PushL(import);
+// // import the attachment
+// err = import->WriteData(aMessageText);
+// // tell CAF (and hence the agent) it's now got the entire file
+// if (err == KErrNone)
+// err = import->WriteDataComplete();
+// if (err == KErrNone)
+// // Look at the output of the import operation
+// for(TInt i = 0; i < import->OutputFileCountL(); i++)
+// // for this example only add content output files
+// // (absorb any rights in the original attachment 'silently')
+// if(import->OutputFilesL(i).OutputType == EContent)
+// // Add file to list of attachments for this message
+// AddAttachment(import->OutputFilesL(i).FileName());
+// // Error handling
+// if (err != KErrNone)
+// if (err == KErrNotReady)	
+// DisplayErrorMsg("Agent not ready for import");
+// else if (err == KErrCACorruptContent)
+// DisplayErrorMsg("Content data is corrupt");
+// else
+// DisplayErrorMsg("Unexpected error: %d", err);
+// // Finished
+// CleanupStack::PopAndDestroy(2);		// metaDataArray, import
+// <hr>
+// This example shows how a messaging application that has just received
+// a message attachment from a mail server can offer the attachment
+// to CAF for processing and store the file in its own private directory.
+// void CMyApp::ReceiveMessageAttachment(const TDesC8& aContentType, const TDesC8& aMessageAttachment)
+// // Create supplier object
+// CSupplier* supplier = CSupplier::NewLC();
+// // Check if CAF can import this attachment we just received
+// if(supplier->IsImportSupported(aContentType))
+// ProcessAttachmentL(supplier, aContentType, aMessageAttachment);	
+// else
+// // just save the message to a file in its current form
+// RFile theFile;
+// theFile.Open(iFs, "myFile");
+// theFile.Write(aMessageAttachment);
+// theFile.Close();
+// // Add the file to the list of attachments
+// AddAttachment("myFile");
+// void CMyApp::ProcessAttachmentL(CSupplier* aSupplier, const TDesC8& aContentType, const TDesC8& aMessageAttachment)
+// TInt err = KErrNone;
+// TBuf <128> buf;
+// TBuf <4> fileExtension;
+// _LIT(KOutputFileName, "\\private\\12345678\\outputfile.");
+// TFileName fileName(KOutputFileExtension);
+// RFile file;
+// // Create meta-data array
+// CMetaDataArray* metaDataArray = CMetaDataArray::NewLC();
+// // Add any useful information we can think of....
+// // Obviously these would not be hardcoded this way in a real import
+// metaDataArray->AddL(_L("Content Type"), _L("application/vnd.oma.drm.dm"));
+// metaDataArray->AddL(_L("Content Length"), _L("1201"));
+// metaDataArray->AddL(_L("X-Oma-Drm-Separate-Delivery"), _L("6"));
+// // Create the import object, no suggested file name implies the application will supply output files
+// CImportFile* import = aSupplier->ImportFileL(aContentType, *metaDataArray);
+// CleanupStack::PushL(import);
+// // Start importing the attachment
+// // (if the agent needs one or more output files, continue looping until 
+// // the agent finishes the previous)
+// TInt err = import->WriteData(aMessageText);
+// while(err == KErrCANewFileHandleRequired)
+// import->GetSuggestedOutputFileExtension(fileExtension);
+// filName.Append(fileExtension);
+// User::LeaveIfError(file.Open(iFs, fileName));
+// err = import->ContinueWithNewOutputFile(file);
+// file.Close();
+// if (err == KErrNone)
+// // Complete the import process
+// err = import->WriteDataComplete();
+// while(err == KErrCANewFileHandleRequired)
+// import->GetSuggestedOutputFileExtension(fileExtension);
+// filName.Append(fileExtension);
+// User::LeaveIfError(file.Open(iFs, fileName));
+// err = import->ContinueWithNewOutputFile(file);
+// file.Close();
+// if (err == KErrNone)
+// // Look at the output of the import operation
+// for(TInt i = 0; i < import->OutputFileCountL(); i++)
+// // for this example only add content output files
+// // (absorb any rights in the original attachment 'silently')
+// if(import->OutputFilesL(i).OutputType == EContent)
+// // Add file to list of attachments for this message
+// AddAttachment(import->OutputFilesL(i).FileName());
+// // Error handling
+// if (err != KErrNone)
+// if (err == KErrNotReady)	
+// DisplayErrorMsg("Agent not ready for import");
+// else if (err == KErrCACorruptContent)
+// DisplayErrorMsg("Content data is corrupt");
+// else
+// DisplayErrorMsg("Unexpected error: %d", err);
+// // Finshed
+// CleanupStack::PopAndDestroy(2);		// metaDataArray, import
+// 
+//
+
+/**
+ @page CAFExamples Example source code using CAF
+ - @ref ExampleRead1
+ - @ref ExampleReadWithErrCheck
+ - @ref PlayingUnprotectedOnly 
+ - @ref MultipleContentExample
+ - @ref ExampleSupplier1
+ - @ref ExampleSupplier2
+ @section ExampleRead1 Reading from a file, no error checking
+ @code
+ @endcode
+ @section ExampleReadWithErrCheck Reading from a file, with error checking
+ @code
+ @endcode
+ @section PlayingUnprotectedOnly Preventing access to DRM content
+ @code
+ @endcode
+ @section MultipleContentExample File containing several content objects
+ @code
+ @endcode
+ @section ExampleSupplier1 Importing a content file, agent provides output files
+ @code
+ @endcode
+ @section ExampleSupplier2 Importing a content file, application provides output files
+ @code
+ @endcode
+*/