sl@0: // Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of the License "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // <hr>
sl@0: // The \c default_data section of an CA Agent or CA Agent proxy's resource file is 
sl@0: // used to specify three pieces of information:
sl@0: // The buffer size section is separated from the supplier MIME types by a '<code>|</code>' character 
sl@0: // and the supplier MIME types are separated from the consumer MIME types by a '<code>:</code>' character.
sl@0: // Below is an example for an OMA DRM agent. 
sl@0: // default_data="100|application/vnd.oma.drm.message,application/vnd.oma.drm.rights+xml:application/vnd.oma.drm.content";
sl@0: // <hr>
sl@0: // The \c opaque_data section is used to specify the agent's private directory under <code>c:\\private\\</code>. This will be the 
sl@0: // SID (SecureId) of the server who owns the directory, e.g.
sl@0: // opaque_data="12345678";
sl@0: // If the agent does not have a corresponding private directory or does not wish to provide access to that directory, it
sl@0: // should just leave the \c opaque_data section as an empty string.
sl@0: // <hr>
sl@0: // // 101FE8F1.rss
sl@0: // // UIDs quick-ref
sl@0: // // ECOM DLL UID:		0x101FE8F1
sl@0: // // CA Agent interface UID:	0x10204740
sl@0: // // Test CAA Implementation:	0x101FE8F2
sl@0: //
sl@0: 
sl@0: // #include <ecom/registryinfo.rh>
sl@0: // RESOURCE REGISTRY_INFO theInfo
sl@0: // dll_uid = 0x101FE8F1;
sl@0: // interfaces =
sl@0: // INTERFACE_INFO
sl@0: // interface_uid = 0x10204740;
sl@0: // implementations = 
sl@0: // IMPLEMENTATION_INFO
sl@0: // implementation_uid = 0x101FE8F2;
sl@0: // version_no = 1;
sl@0: // display_name = "Test Agent";
sl@0: // default_data = "255|application/vnd.oma.drm.message,application/vnd.oma.drm.content:application/vnd.oma.drm.content"; // Sample CAF types
sl@0: // opaque_data = "12345678";
sl@0: // <hr>
sl@0: // When writing a new CA Agent, all other UIDs used in the above examples should 
sl@0: // be replaced by new UIDs from the Symbian UID generator. 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @page CAA_Configuration Content Access Agent ECOM Resource File
sl@0:  - @ref default_data
sl@0:  - @ref opaque_data
sl@0:  - @ref RSSExample
sl@0:  - @ref UIDs
sl@0:  @section default_data default_data
sl@0:  @li The buffer size required by this agent to recognize a file when <code>ContentAccess::CAgentManager::RecognizeFileL()</code> is called
sl@0:  @li A list of supplier MIME types supported by this agent
sl@0:  @li A list of consumer MIME types supported by this agent.
sl@0:  @code
sl@0:  @endcode
sl@0:  @li It requires at least the first 100 bytes of a file in order to do recognition
sl@0:  @li It supports a supplier MIME types of <code>application/vnd.oma.drm.message</code> and <code>application/vnd.oma.drm.rights+xml</code>
sl@0:  @li It supports a consumer MIME type of <code>application/vnd.oma.drm.content</code>.
sl@0:  @section opaque_data opaque_data
sl@0:  @code
sl@0:  @endcode
sl@0:  @section RSSExample An Example Agent Resource File
sl@0:  @code
sl@0:  @endcode
sl@0:  @section UIDs Important UIDs for CA Agents
sl@0:  @li \c 0x10009D8D - the ECOM DLL UID. Identifies a DLL as an ECOM plugin
sl@0:  @li \c 0x101FC2CE - The Content Access Agent v1.0 interface, an implementation of <code>ContentAccess::CAgentFactory::NewL()</code>.
sl@0:  @li \c 0x10204740 - The Content Access Agent v2.0 interface, an implementation of <code>ContentAccess::CAgentFactory::NewL()</code>.
sl@0: */