os/security/contentmgmt/contentaccessfwfordrm/source/f32agent/f32agentfactory.h
author sl@SLION-WIN7.fritz.box
Fri, 15 Jun 2012 03:10:57 +0200
changeset 0 bde4ae8d615e
permissions -rw-r--r--
First public contribution.
sl@0
     1
/*
sl@0
     2
* Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0
     3
* All rights reserved.
sl@0
     4
* This component and the accompanying materials are made available
sl@0
     5
* under the terms of the License "Eclipse Public License v1.0"
sl@0
     6
* which accompanies this distribution, and is available
sl@0
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0
     8
*
sl@0
     9
* Initial Contributors:
sl@0
    10
* Nokia Corporation - initial contribution.
sl@0
    11
*
sl@0
    12
* Contributors:
sl@0
    13
*
sl@0
    14
* Description: 
sl@0
    15
*
sl@0
    16
*/
sl@0
    17
sl@0
    18
sl@0
    19
/**
sl@0
    20
 @file
sl@0
    21
 @internalComponent
sl@0
    22
 @released
sl@0
    23
*/
sl@0
    24
sl@0
    25
sl@0
    26
#ifndef __F32AGENTFACTORY_H__
sl@0
    27
#define __F32AGENTFACTORY_H__
sl@0
    28
sl@0
    29
#include <caf/agentfactory.h>
sl@0
    30
sl@0
    31
namespace ContentAccess
sl@0
    32
	{
sl@0
    33
	class CAgentContent;
sl@0
    34
	class CAgentManager;
sl@0
    35
	class CAgentData;
sl@0
    36
sl@0
    37
	/** 
sl@0
    38
	 Creates products that allow access to plaintext unprotected files
sl@0
    39
	 via the Content Access Framework (CAF)
sl@0
    40
	 
sl@0
    41
	 The F32 agent is treated as a special case by CAF. It is 
sl@0
    42
	 the default agent used when no other suitable agent is found
sl@0
    43
	 for a particular operation.
sl@0
    44
	 
sl@0
    45
	 No translation of the content will occur and no access restrictions
sl@0
    46
	 will be enforced aside from the usual platform security data caging
sl@0
    47
	 rules.
sl@0
    48
	 
sl@0
    49
	 @internalComponent
sl@0
    50
	 @released
sl@0
    51
	 */
sl@0
    52
	class CF32AgentFactory : public CAgentFactory
sl@0
    53
		{
sl@0
    54
	public:
sl@0
    55
		/** Entry point for F32 Agent 
sl@0
    56
		@return a new F32AgentFactory instance
sl@0
    57
		*/
sl@0
    58
		static CAgentFactory* NewL();
sl@0
    59
		
sl@0
    60
		// From CAgentFactory
sl@0
    61
		virtual CAgentContent* CreateContentBrowserL(const TDesC& aURI, TContentShareMode aShareMode);	
sl@0
    62
		virtual CAgentContent* CreateContentBrowserL(RFile& aFile);
sl@0
    63
		virtual CAgentData* CreateDataConsumerL(const TVirtualPathPtr& aVirtualPath, TContentShareMode aShareMode);
sl@0
    64
		virtual CAgentData* CreateDataConsumerL(RFile& aFile, const TDesC& aUniqueId);
sl@0
    65
		virtual CAgentManager*  CreateManagerL();
sl@0
    66
sl@0
    67
		/** The F32 Agent cannot be used to receive files
sl@0
    68
		
sl@0
    69
		The CAF framework should know this is the F32 agent and never
sl@0
    70
		attempt to call this method
sl@0
    71
		
sl@0
    72
		@panic CAF EF32AgentImportNotSupported 
sl@0
    73
		*/
sl@0
    74
		virtual CAgentImportFile* CreateImporterL(const TDesC8& aMimeType, const CMetaDataArray& aMetaDataArray, const TDesC& aOutputDirectory, const TDesC& aSuggestedFileName);
sl@0
    75
		/** The F32 Agent cannot be used to receive files
sl@0
    76
sl@0
    77
		The CAF framework should know this is the F32 agent and never
sl@0
    78
		attempt to call this method
sl@0
    79
sl@0
    80
		@panic CAF EF32AgentImportNotSupported 
sl@0
    81
		*/
sl@0
    82
		virtual CAgentImportFile* CreateImporterL(const TDesC8& aMimeType, const CMetaDataArray& aMetaDataArray);
sl@0
    83
		/** The F32 Agent does not manage any rights
sl@0
    84
sl@0
    85
		The CAF framework should know this is the F32 agent and never
sl@0
    86
		attempt to call this method
sl@0
    87
sl@0
    88
		@panic CAF EF32AgentRightsManagerNotSupported 
sl@0
    89
		*/
sl@0
    90
		virtual CAgentRightsManager* CreateRightsManagerL();
sl@0
    91
		
sl@0
    92
#ifdef SYMBIAN_ENABLE_SDP_WMDRM_SUPPORT
sl@0
    93
		virtual CAgentData* CreateDataConsumerL(const TDesC8& aHeaderData);
sl@0
    94
		virtual CAgentContent* CreateContentBrowserL(const TDesC8& aHeaderData);
sl@0
    95
#endif // SYMBIAN_ENABLE_SDP_WMDRM_SUPPORT		
sl@0
    96
		};
sl@0
    97
} // namespace ContentAccess
sl@0
    98
#endif // __F32AGENTFACTORY_H__