diff -r 675a964f4eb5 -r 35751d3474b7 contentmgmt/contentaccessfwfordrm/inc/content.h --- a/contentmgmt/contentaccessfwfordrm/inc/content.h Tue Jul 21 01:04:32 2009 +0100 +++ b/contentmgmt/contentaccessfwfordrm/inc/content.h Thu Sep 10 14:01:51 2009 +0300 @@ -1,999 +1,1002 @@ -/* -* Copyright (c) 2003-2007 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: -* -*/ - - -/** -@file - -@publishedPartner -@released -*/ - - -#ifndef __CONTENT_H__ -#define __CONTENT_H__ - -#include -#include - -#include -#include -#include -#include - -namespace ContentAccess - { - class CAgentResolver; - class CAgentFactory; - class CAgentContent; - class CData; - class CEmbeddedObject; - class RAttributeSet; - class RStringAttributeSet; - - - -#ifndef REMOVE_CAF1 - class CAttribute; -#endif - - -/** - CContent allows applications to browse the content objects contained within a - single file and construct a CData object for reading that content. - - Applications will use an object of this type rather than the traditional - RFile mechanisms. They will, however, be required to indicate - DRM Intent - something that determines whether (and how) access to - the content should be permitted by a Content-Access agent. - - CContent allows direct access to meta-data such as the attributes of - the content and indirect access to the plaintext data itself through - the CData class. - - Applications can use CContent to browse the hierarchy of content objects - within a file containing several content objects. - - During construction CContent loads the correct CAF Agent plugin to handle - the file specified by the URI. - - @publishedPartner - @released - */ - class CContent : public CBase - { - public: - - /** - Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr - - @param aURI The filename, URI or virtual path of the DRM file. - @return a new CContent object. - @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C static CContent* NewLC(const TDesC& aURI); - - /** - Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr - - @param aURI The filename, URI or virtual path of the DRM file. - @return a new CContent object. - @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C static CContent* NewL(const TDesC& aURI); - - /** - Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr - - @param aURI The filename, URI or virtual path of the DRM file. - @param aShareMode The sharing mode used when accessing the content. - @return a new CContent object. - @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. - @leave KErrAccessDenied If the file is already open with a different share mode. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C static CContent* NewLC(const TDesC& aURI, TContentShareMode aShareMode); - - /** - Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr - - @param aURI The filename, URI or virtual path of the DRM file. - @param aShareMode The sharing mode used when accessing the content. - @return a new CContent object. - @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. - @leave KErrAccessDenied If the file is already open with a different share mode. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C static CContent* NewL(const TDesC& aURI, TContentShareMode aShareMode); - - /** - Constructs a new CContent object with an open file handle. - - CContent will use a duplicate of this file handle, the client is - free to close its file handle any time after creating the CContent - object. - - @param aFile The file handle. The file must already be open before calling NewLC. - The underlying RFs session should be shared for transfer to other processes using RFs::ShareProtected(), since the agent may use transfer this handle to its own or one of the system servers. - @return a new CContent object. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C static CContent* NewLC(RFile& aFile); - - /** - Constructs a new CContent object with an open file handle. - - CContent will use a duplicate of this file handle, the client is - free to close its file handle any time after creating the CContent - object. - - @param aFile The file handle. The file must already be open before calling this method. - The underlying RFs session should be shared for transfer to other processes using RFs::ShareProtected(), since the agent may use transfer this handle to its own or one of the system servers. - @return a new CContent object. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C static CContent* NewL(RFile& aFile); - - /** destructor */ - virtual ~CContent(); - - /** Open a Container object within the file. - - Allows an application to access the content objects and - any nested container objects within the specified container. - - @param aUniqueId The container object's unique ID. - @return Whether the container was opened. - @return KErrNone if the container was opened successfully. - @return KErrNotFound if the container does not exist. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt OpenContainer(const TDesC& aUniqueId); - - /** Close the current container object and go back to previous enclosing - container within the file. - - Allows an application to access the content objects and - any nested container objects within parent container. - - @return Whether the container was closed. - @return KErrNone if the container was closed. - @return KErrNotFound if there is no enclosing container. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt CloseContainer(); - - /** List all the embedded container objects and content objects within the - current container - - The UniqueId() member of CEmbeddedObject can be used to refer directly to - a particular object within the file. - - @code - // Create a ccontent object for the file of interest - CContent* content = CContent::NewLC(uri); - - // Define an array to store the results - RStreamablePtrArray array; - CleanupClosePushL(array); - - // Find all the content and container objects within the current container - content->GetEmbeddedObjectsL(array); - - // Do something with the array - .... - - // Finished - CleanupStack::PopAndDestroy(2); - @endcode - - @param aArray The array to be populated with the embedded objects. - @leave KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C void GetEmbeddedObjectsL(RStreamablePtrArray& aArray) const; - - /** List all the embedded objects within the current container that - are of the specified type - - @code - // Create a ccontent object for the file of interest - CContent* content = CContent::NewLC(uri); - - // Define an array to store the results - RStreamablePtrArray array; - CleanupClosePushL(array); - - // Find all the content objects within the current container - content->GetEmbeddedObjectsL(array, EContentObject); - - // Do something with the array - .... - - // Finished - CleanupStack::PopAndDestroy(2); - @endcode - - @param aArray The array to be populated with the embedded objects. - @param aType The type of objects to list. - @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. - @leave ... One of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C void GetEmbeddedObjectsL(RStreamablePtrArray& aArray, TEmbeddedType aType) const; - - /** Search the current container for content objects with a particular mime type - - @code - _LIT8(KTextPlainMimeType, "text/plain"); - - // Create a ccontent object for the file of interest - CContent* content = CContent::NewLC(uri); - - // Define an array to store the results - RStreamablePtrArray array; - CleanupClosePushL(array); - - // Recursively search for all the content objects with the - // specified mime type - User::LeaveIfError(content->Search(array, KTextPlainMimeType(), ETrue)); - - // Do something with the array - .... - - // Finished - CleanupStack::PopAndDestroy(2); - @endcode - - @param aArray The array to store the results of the search. The agent will add CEmbeddedObject objects to the supplied array. - @param aMimeType The mime type to search for. - @param aRecursive ETrue to search inside containers embedded within the current container, EFalse to search only the current container. - @return The result of the search. - @return KErrNone if the search was successful, even if no content objects were found. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt Search(RStreamablePtrArray& aArray, const TDesC8& aMimeType, TBool aRecursive); - - - /** Get an attribute for the default content object within the file - - @see ContentAccess::TAttribute - - @code - TInt value = 0; - CContent* c = CContent::NewL(uri); - TInt err =c->GetAttribute(EIsProtected, value); - if(err == KErrNone && value) - { - DisplayPadLock(); - } - @endcode - - @param aAttribute The attribute to query, from ContentAccess::TAttribute. - @param aValue Used to return the attribute value. - @return Whether the attribute value was updated. - @return KErrNone if the value of the attribute was updated. - @return KErrNotFound if the object with the given UniqueId was not found. - @return KErrCANotSupported if the requested attribute does not exist. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetAttribute(TInt aAttribute, TInt& aValue) const; - - /** Get an attribute for an object within the file - - @see ContentAccess::TAttribute - - @code - TInt value = 0; - CContent* c = CContent::NewL(uri); - TInt err =c->GetAttribute(EIsProtected, value, uniqueId); - if(err == KErrNone && value) - { - DisplayPadLock(); - } - @endcode - - @param aAttribute The attribute to query, from ContentAccess::TAttribute. - @param aValue Used to return the attribute value. - @param aUniqueId The UniqueId of the object within the file. - @return Whether the attribute value was updated. - @return KErrNone if the value of the attribute was updated. - @return KErrNotFound if the object with the given UniqueId was not found. - @return KErrCANotSupported if the requested attribute does not exist. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetAttribute(TInt aAttribute, TInt& aValue, const TDesC& aUniqueId) const; - - - /** Get a set of attributes for the default content object within the file - - @see ContentAccess::TAttribute - - The following example determines whether the default content object - is protected and has rights that will enable it to be viewed by the - user - - @code - CContent* content = CContent::NewLC(uri); - - RAttributeSet attributeSet; - CleanupClosePushL(attributeSet); - attributeSet->AddL(EProtected); - attributeSet->AddL(ECanView); - - User::LeaveIfError(content->GetAttributeSet(attributeSet); - - TInt err = attributeSet.GetValue(EProtected, value); - if(err == KErrNone && value) - { - // file is DRM protected - } - - err = attributeSet.GetValue(ECanView, value); - if(err == KErrNone && value) - { - // File has rights that allow it to be displayed on screen - } - - // Finished - CleanupStack::PopAndDestroy(2); // content, attributeSet.Close() - @endcode - - - @param aAttributeSet The set of attributes to query and update. - @return Whether the attribute set was updated. - @return KErrNone if the attributes were retrieved successfully. - @return KErrNotFound if the default content object was not found. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetAttributeSet(RAttributeSet& aAttributeSet) const; - - /** Get a set of attributes from an object within the file - - @see ContentAccess::TAttribute - - The following example determines whether the default content object - is protected and has rights that will enable it to be viewed by the - user - - @code - CContent* content = CContent::NewLC(uri); - - RAttributeSet attributeSet; - CleanupClosePushL(attributeSet); - attributeSet->AddL(EProtected); - attributeSet->AddL(ECanView); - - User::LeaveIfError(content->GetAttributeSet(attributeSet, uniqueId); - - TInt err = attributeSet.GetValue(EProtected, value); - if(err == KErrNone && value) - { - // file is DRM protected - } - - err = attributeSet.GetValue(ECanView, value); - if(err == KErrNone && value) - { - // File has rights that allow it to be displayed on screen - } - - // Finished - CleanupStack::PopAndDestroy(2); // content, attributeSet.Close() - @endcode - - - @param aAttributeSet The set of attributes to query and update. - @param aUniqueId The unique ID of the object within the file. - @return Whether that attribute set was updated. - @return KErrNone if the attributes were retrieved successfully. - @return KErrNotFound if the default content object was not found. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetAttributeSet(RAttributeSet& aAttributeSet, const TDesC& aUniqueId) const; - - /** Get text string attributes or meta-data for the default content object within the file - - @see ContentAccess::TStringAttribute - - @code - TInt err = KErrNone; - - CContent* c = CContent::NewL(uri); - TBuf previewUri; - err = c->GetStringAttribute(EPreviewURI, previewUri); - if(err == KErrNone) - { - DisplayPreview(previewUri); - } - @endcode - - @param aAttribute The attribute to query, from ContentAccess::TStringAttribute. - @param aValue Returns the value of the attribute. - @return Whether the attribute value was updated. - @return KErrNone if the attribute was retrieved. - @return KErrNotFound if the default content object was not found. - @return KErrOverflow if the buffer was not large enough to return the result. - @return KErrCANotSupported if the requested attribute does not exist. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetStringAttribute(TInt aAttribute, TDes& aValue) const; - - /** Get text string attributes or meta-data for an object within the file - - @see ContentAccess::TStringAttribute - - @code - TInt err = KErrNone; - - CContent* c = CContent::NewL(uri); - TBuf previewUri; - err = c->GetStringAttribute(EPreviewURI, previewUri, uniqueId); - if(err == KErrNone) - { - DisplayPreview(previewUri); - } - @endcode - - @param aAttribute The attribute to query, from ContentAccess::TStringAttribute. - @param aValue Returns the value of the attribute. - @param aUniqueId The UniqueId of the object within the file. - @return Whether the attribute value was updated. - @return KErrNone if the attribute was retrieved. - @return KErrNotFound if the object with the given UniqueId was not found. - @return KErrOverflow if the buffer was not large enough to return the result. - @return KErrCANotSupported if the requested attribute does not exist. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetStringAttribute(TInt aAttribute, TDes& aValue, const TDesC& aUniqueId) const; - - /** Obtain a set of string attributes for the default content object within the file - - @see ContentAccess::TStringAttribute - - @code - CContent* content = CContent::NewLC(uri); - - // create the attribute set, add the attributes we are interested in - RStringAttributeSet stringAttributeSet; - CleanupClosePushL(stringAttributeSet); - stringAttributeSet.AddL(EPreviewURI); - stringAttributeSet.AddL(ETitle); - - User::LeaveIfError(content->GetStringAttributeSet(stringAttributeSet)); - - // Pass the value of the string attribute to DisplayPreview() - TFileName previewUri; - TInt err = stringAttributeSet.GetValue(EPreviewURI, previewUri); - if(err == KErrNone) - { - DisplayPreview(previewUri); - } - - CleanupStack::PopAndDestroy(2); // content, stringAttributeSet.Close() - @endcode - - - @param aStringAttributeSet The set of attributes to query and update. - @return Whether the attribute set was updated. - @return KErrNone if the attributes were retrieved successfully. - @return KErrNotFound if the default content object was not found. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetStringAttributeSet(RStringAttributeSet& aStringAttributeSet) const; - - /** Used to obtain a set of string attributes for an object within the file - - @see ContentAccess::TStringAttribute - - @code - CContent* content = CContent::NewLC(uri); - - // create the attribute set, add the attributes we are interested in - RStringAttributeSet stringAttributeSet; - CleanupClosePushL(stringAttributeSet); - stringAttributeSet.AddL(EPreviewURI); - stringAttributeSet.AddL(ETitle); - - User::LeaveIfError(content->GetStringAttributeSet(stringAttributeSet, uniqueId)); - - // Pass the value of the string attribute to DisplayPreview() - TFileName previewUri; - TInt err = stringAttributeSet.GetValue(EPreviewURI, previewUri); - if(err == KErrNone) - { - DisplayPreview(previewUri); - } - - CleanupStack::PopAndDestroy(2); // content, stringAttributeSet.Close() - @endcode - - - @param aStringAttributeSet The set of attributes to query and update. - @param aUniqueId The UniqueId of the container or content. - @return Whether the attribute set was updated. - @return KErrNone if the attributes were retrieved successfully. - @return KErrNotFound if the object with the given UniqueId was not found. - @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. - @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C TInt GetStringAttributeSet(RStringAttributeSet& aStringAttributeSet, const TDesC& aUniqueId) const; - - /** Allows extended synchronous calls to the CAF agent handling this file - - Applications familiar with the agent can pass objects in and out using serialization. - - @param aCommand The agent defined command. - @param aInputBuffer Non modifyable input data buffer. - @param aOutputBuffer Modifyable output buffer to hold the result of the command. - @return The outcome of the agent specific command. - @return KErrCANotSupported if the agent does not recognize the command. - @return KErrOverflow if the output buffer supplied is too small. - @return KErrPermissionDenied if the agent does not allow the client to execute the command. - @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the - other system-wide error codes for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt AgentSpecificCommand(TInt aCommand, const TDesC8& aInputBuffer, TDes8& aOutputBuffer); - - /** Allows extended synchronous calls to the CAF agent handling this file - Applications familiar with the agent can pass objects in and out using serialization. - NB: It is important that the descriptor passed to - aOutputBuffer remains in scope until the request has completed. - - @param aCommand The agent defined command. - @param aInputBuffer Non modifyable input data buffer. - @param aOutputBuffer Modifyable output buffer to hold the result of the command. - @param aStatus Asynchronous request status. On completion this will contain - one of the following error codes: - KErrNone if the command was successfully executed. - KErrCANotSupported if the agent does not recognize the command. - KErrOverflow if the output buffer supplied is too small. - KErrPermissionDenied if the agent does not allow the client - to execute the command. Otherwise one of the other CAF error codes defined - in \c caferr.h or one of the other system-wide error codes - for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C void AgentSpecificCommand(TInt aCommand, const TDesC8& aInputBuffer, TDes8& aOutputBuffer, TRequestStatus& aStatus); - - - /** Request notification for an event for the default content object within the file - - @see ContentAccess::TEventMask - - @param aMask Bitmask of events the caller is interested in. - @param aStatus The TRequestStatus object to complete if the event occurs. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C void NotifyStatusChange(TEventMask aMask, TRequestStatus& aStatus); - - /** Request notification for an event for an object within the file - - @see ContentAccess::TEventMask - - @param aMask Bitmask of events the caller is interested in. - @param aStatus The TRequestStatus object to complete if the event occurs. - @param aUniqueId The UniqueId of the container or content. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C void NotifyStatusChange(TEventMask aMask, TRequestStatus& aStatus, const TDesC& aUniqueId); - - /** Cancel a previous notification request for the default content object - - @param aStatus The TRequestStatus supplied in the call to NotifyStatusChange(). - @return The outcome of the cancel request. - @return KErrNone if the request was cancelled. - @return KErrNotFound if there was no matching request outstanding. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt CancelNotifyStatusChange(TRequestStatus& aStatus); - - /** Cancel a previous notification request - - @param aStatus The TRequestStatus supplied in the call to NotifyStatusChange(). - @param aUniqueId The UniqueId of the content object within the file. - @return The outcome of the cancel request. - @return KErrNone if the request was cancelled. - @return KErrNotFound if there was no matching request outstanding. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt CancelNotifyStatusChange(TRequestStatus& aStatus, const TDesC& aUniqueId); - - /** Request the agent to obtain rights for the default content object - - This request may be handled differently by different agents. - Some agents may open a browser and direct the user to a URL. Others may - download and install the rights in the background. - - The call should not block execution, applications can wait for a notification - if they are interested in the outcome. - - @param aStatus Asynchronous request status. On completion this will contain - one of the following error codes: - KErrNone if the rights request was successful. - KErrCANotSupported if the agent does not allow rights requests. - Otherwise one of the other CAF error codes defined in \c caferr.h - or one of the other system-wide error codes - for any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C void RequestRights(TRequestStatus& aStatus); - - /** Request the agent to obtain rights for a protected content object - - This request may be handled differently by different agents. - Some agents may open a browser and direct the user to a URL. Others may - download and install the rights in the background. - - The call should not block execution, applications can wait for a notification - if they are interested in the outcome. - - @param aStatus Asynchronous request status. On completion this will contain - one of the following error codes: - KErrNone if the rights request was successful. - KErrCANotSupported if the agent does not allow rights requests. - Otherwise one of the other CAF error codes defined in \c caferr.h - or one of the other system-wide error codes - for any other errors. - - @param aUniqueId The unique id of the object within the file. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C void RequestRights(TRequestStatus& aStatus, const TDesC& aUniqueId); - - - /** Cancel a previous RequestRights() request for the default content object - - @param aStatus The TRequestStatus that was supplied to the RequestRights() function. - @return The result of the cancel rights request. - @return KErrNone if the rights request was cancelled. - @return KErrNotFound if there was no matching rights request outstanding. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt CancelRequestRights(TRequestStatus& aStatus); - - /** Cancel a previous RequestRights() request - - @param aStatus The TRequestStatus that was supplied to the RequestRights() function. - @param aUniqueId The objects Unique Id that was supplied to the RequestRights() function. - @return The result of the cancel rights request. - @return KErrNone if the rights request was cancelled. - @return KErrNotFound if there was no matching rights request outstanding. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt CancelRequestRights(TRequestStatus& aStatus, const TDesC& aUniqueId); - - /** View information associated with the default content object - - This call blocks execution and only returns once the display is dismissed - by the user. - - @see ContentAccess::TDisplayInfo - - @param aInfo The information to display. - @leave KErrCANotSupported if information cannot be displayed or does not exist. - @leave ... One of the other CAF error codes defined in \c caferr.h - or one of the system-wide error codes for - any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C void DisplayInfoL(TDisplayInfo aInfo) const; - - /** View information associated with a single content object - - This call blocks execution and only returns once the display is dismissed - by the user. - - @see ContentAccess::TDisplayInfo - - @param aInfo The information to display. - @param aUniqueId The unique id of the object within the file. - @leave KErrCANotSupported if information cannot be displayed or does not exist. - @leave ... One of the other CAF error codes defined in \c caferr.h - or one of the system-wide error codes for - any other errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C void DisplayInfoL(TDisplayInfo aInfo, const TDesC& aUniqueId) const; - - - /** Request the agent handling this content to set a property value. If - the property is set it is only set for this CContent session and does not - impact other CAF users and is not set for CData products created by the - CContent. - - @see ContentAccess::TAgentProperty - - @param aProperty The property to set. - @param aValue The value of the property. - @return Whether the property was set. - @return KErrNone if the property was set. - @return KErrCANotSupported if the agent does not support the property or value. - @return KErrAccessDenied if the agent does not permit the property to be changed. - @return KErrPermissionDenied if the application does not have the necessary capability to change the property. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C TInt SetProperty(TAgentProperty aProperty, TInt aValue); - - /** - Grants read access to the default content object based on - evaluation of the supplied intent information. - - Note that the intent is simply evaluated and not executed. - To force the intent to be executed, clients must use the call - ContentAccess::CData::ExecuteIntent(). - - A CData object can be obtained as follows: - @code - CData* MyData = myContent->OpenContentL(ChosenIntent); - ... - delete MyData; // when finished accessing plaintext content - @endcode - - @see ContentAccess::TIntent - - @param aIntent The intent indicator. - @return A CData instance. The caller gets ownership of this object. - - @leave KErrNotFound The content object with the given UniqueId does not exist. - @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. - @leave KErrCANoPermission Rights exist but the specified intent is not permitted. - @leave KErrCANoRights No rights exist for the content object. - @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. - @leave KErrPermissionDenied The agent does not allow the client to access the content object. - @leave KErrAccessDenied The content is already in use. - @leave ... One of the other CAF error codes defined in \c caferr.h - or one of the other system-wide error codes for any other - errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C CData* OpenContentL(TIntent aIntent); - - /** - Grants read access to the default content object based on - evaluation of the supplied intent information. - - Note that the intent is simply evaluated and not executed. - To force the intent to be executed, clients must use the call - ContentAccess::CData::ExecuteIntent(). - - A CData object can be obtained as follows: - @code - CData* myData = myContent->OpenContentLC(ChosenIntent); - ... - // when finished accessing plaintext content - CleanupStack::PopAndDestroy(myData); - @endcode - - @see ContentAccess::TIntent - - @param aIntent The intent indicator. - @return A CData instance. The caller gets ownership of this object. - - @leave KErrNotFound The content object with the given UniqueId does not exist. - @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. - @leave KErrCANoPermission Rights exist but the specified intent is not permitted. - @leave KErrCANoRights No rights exist for the content object. - @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. - @leave KErrPermissionDenied The agent does not allow the client to access the content object. - @leave KErrAccessDenied The content is already in use. - @leave ... One of the other CAF error codes defined in \c caferr.h - or one of the other system-wide error codes for any other - errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. - */ - IMPORT_C CData* OpenContentLC(TIntent aIntent); - - /** - Grants read access to the content object based on evaluation of the - supplied intent information. - - Note that the intent is simply evaluated and not executed. - To force the intent to be executed, clients must use the call - ContentAccess::CData::ExecuteIntent(). - - A CData object can be obtained as follows: - @code - CData* MyData = myContent->OpenContentL(ChosenIntent, uniqueId); - ... - delete MyData; // when finished accessing plaintext content - @endcode - - @see ContentAccess::TIntent - - @param aIntent The intent indicator. - @param aUniqueId The object to open for reading. If the UniqueId is set to KNullDesC16() the entire file will be opened for reading with no transformation. - @return A CData instance. The caller gets ownership of this object. - - @leave KErrNotFound The content object with the given UniqueId does not exist. - @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. - @leave KErrCANoPermission Rights exist but the specified intent is not permitted. - @leave KErrCANoRights No rights exist for the content object. - @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. - @leave KErrPermissionDenied The agent does not allow the client to access the content object. - @leave KErrAccessDenied The content is already in use. - @leave ... One of the other CAF error codes defined in \c caferr.h - or one of the other system-wide error codes for any other - errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C CData* OpenContentL(TIntent aIntent, const TDesC& aUniqueId); - - - /** - Grants read access to the content object based on evaluation of the - supplied intent information. - - Note that the intent is simply evaluated and not executed. - To force the intent to be executed, clients must use the call - ContentAccess::CData::ExecuteIntent(). - - A CData object can be obtained as follows: - @code - CData* MyData = myContent->OpenContentLC(ChosenIntent, uniqueId); - ... - PopAndDestroy(MyData); // when finished accessing plaintext content - @endcode - - @see ContentAccess::TIntent - - @param aIntent The intent indicator. - @param aUniqueId The object to open for reading. If the UniqueId is set to KNullDesC16() the entire file will be opened for reading with no transformation. - @return A CData instance. The caller gets ownership of this object. - - @leave KErrNotFound The content object with the given UniqueId does not exist. - @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. - @leave KErrCANoPermission Rights exist but the specified intent is not permitted. - @leave KErrCANoRights No rights exist for the content object. - @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. - @leave KErrPermissionDenied The agent does not allow the client to access the content object. - @leave KErrAccessDenied The content is already in use. - @leave ... One of the other CAF error codes defined in \c caferr.h - or one of the other system-wide error codes for any other - errors. - @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted - */ - IMPORT_C CData* OpenContentLC(TIntent aIntent, const TDesC& aUniqueId); - - - /** Find out which agent is handling this file - @return The agent handling the File - @capability DRM Access to DRM agents is not permitted for processes without DRM capability - */ - IMPORT_C const TAgent& Agent() const; - -#ifndef REMOVE_CAF1 - /** Create a CData object for reading the content - - @see ContentAccess::TIntent - @param aIntent The intended use of the content - @param aShareMode The mode used to open the file. If EContentShareExclusive is required, use CData::NewL() instead - @return A new CData object - @leave One of the CAF error codes defined in \c caferr.h or one of the system-wide error codes for any errors. - @capability DRM Access to DRM agents is not permitted for processes without DRM capability - @deprecated - */ - IMPORT_C CData* OpenContentL(TIntent aIntent, TContentShareMode aShareMode); - - /** Create a CAttribute object to determine the attributes of the default content object - - @return The agent handling the File - @capability DRM Access to DRM agents is not permitted for processes without DRM capability - @deprecated - */ - IMPORT_C CAttribute* NewAttributeL(TBool aPreloaded); - - /** Create a CAttribute object to determine the attributes of the default content object - - @return The agent handling the File - @capability DRM Access to DRM agents is not permitted for processes without DRM capability - @deprecated - */ - IMPORT_C CAttribute* NewAttributeL(TBool aPreloaded, TContentShareMode aShareMode); - -#endif // REMOVE_CAF1 - - private: - CContent(); - void ConstructL(RFile& aFile); - void ConstructL(const TDesC& aURI, TContentShareMode aShareMode); - - private: - - /** CAgentFactory object is effectively the ECOM session handle */ - CAgentFactory* iAgentFactory; - - /** - Agent object used for browsing the contents of a file - */ - CAgentContent* iAgentContent; - - /** Points to the default content object if the file is opened by name */ - CVirtualPath* iVirtualPath; - - /** The content object referred to by CContent, either points to iVirtualPath - or points to (KNullDesC(), KDefaultContentObject()) - */ - TVirtualPathPtr iDefaultVirtualPath; - - /* Stores the name and UID of the agent - */ - TAgent iAgent; - - /** The share mode used to open the content file*/ - TContentShareMode iShareMode; - - /** Reference to the file handle if the content was opened with a file handle */ - RFile iFile; - }; - - } // namespace ContentAccess -#endif /* __CONTENT_H__ */ +/* +* Copyright (c) 2003-2008 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: +* +*/ + + +/** +@file + +@publishedPartner +@released +*/ + + +#ifndef __CONTENT_H__ +#define __CONTENT_H__ + +#include +#include + +#include +#include +#include +#include + +namespace ContentAccess + { + class CAgentResolver; + class CAgentFactory; + class CAgentContent; + class CData; + class CEmbeddedObject; + class RAttributeSet; + class RStringAttributeSet; + + + +#ifndef REMOVE_CAF1 + class CAttribute; +#endif + + +/** + CContent allows applications to browse the content objects contained within a + single file and construct a CData object for reading that content. + + Applications will use an object of this type rather than the traditional + RFile mechanisms. They will, however, be required to indicate + DRM Intent - something that determines whether (and how) access to + the content should be permitted by a Content-Access agent. + + CContent allows direct access to meta-data such as the attributes of + the content and indirect access to the plaintext data itself through + the CData class. + + Applications can use CContent to browse the hierarchy of content objects + within a file containing several content objects. + + During construction CContent loads the correct CAF Agent plugin to handle + the file specified by the URI. + + @publishedPartner + @released + */ + class CContent : public CBase + { + public: + + /** + Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr + + @param aURI The filename, URI or virtual path of the DRM file. + @return a new CContent object. + @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C static CContent* NewLC(const TDesC& aURI); + + /** + Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr + + @param aURI The filename, URI or virtual path of the DRM file. + @return a new CContent object. + @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C static CContent* NewL(const TDesC& aURI); + + /** + Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr + + @param aURI The filename, URI or virtual path of the DRM file. + @param aShareMode The sharing mode used when accessing the content. + @return a new CContent object. + @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. + @leave KErrAccessDenied If the file is already open with a different share mode. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C static CContent* NewLC(const TDesC& aURI, TContentShareMode aShareMode); + + /** + Constructs a new CContent object with a given URI. The URI can be in the same format as a virtual path for more information see CVirtualPath and TVirtualPathPtr + + @param aURI The filename, URI or virtual path of the DRM file. + @param aShareMode The sharing mode used when accessing the content. + @return a new CContent object. + @leave KErrNotFound If the file at the given URI does not exist or if an invalid URI or virtual path have been supplied. + @leave KErrAccessDenied If the file is already open with a different share mode. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C static CContent* NewL(const TDesC& aURI, TContentShareMode aShareMode); + + /** + Constructs a new CContent object with an open file handle. + + CContent will use a duplicate of this file handle, the client is + free to close its file handle any time after creating the CContent + object. + + @param aFile The file handle. The file must already be open before calling NewLC. + The underlying RFs session should be shared for transfer to other processes using RFs::ShareProtected(), since the agent may use transfer this handle to its own or one of the system servers. + @return a new CContent object. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C static CContent* NewLC(RFile& aFile); + + /** + Constructs a new CContent object with an open file handle. + + CContent will use a duplicate of this file handle, the client is + free to close its file handle any time after creating the CContent + object. + + @param aFile The file handle. The file must already be open before calling this method. + The underlying RFs session should be shared for transfer to other processes using RFs::ShareProtected(), since the agent may use transfer this handle to its own or one of the system servers. + @return a new CContent object. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C static CContent* NewL(RFile& aFile); + + /** destructor */ + virtual ~CContent(); + + /** Open a Container object within the file. + + Allows an application to access the content objects and + any nested container objects within the specified container. + + @param aUniqueId The container object's unique ID. + @return Whether the container was opened. + @return KErrNone if the container was opened successfully. + @return KErrNotFound if the container does not exist. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt OpenContainer(const TDesC& aUniqueId); + + /** Close the current container object and go back to previous enclosing + container within the file. + + Allows an application to access the content objects and + any nested container objects within parent container. + + @return Whether the container was closed. + @return KErrNone if the container was closed. + @return KErrNotFound if there is no enclosing container. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt CloseContainer(); + + /** List all the embedded container objects and content objects within the + current container + + The UniqueId() member of CEmbeddedObject can be used to refer directly to + a particular object within the file. + + @code + // Create a ccontent object for the file of interest + CContent* content = CContent::NewLC(uri); + + // Define an array to store the results + RStreamablePtrArray array; + CleanupClosePushL(array); + + // Find all the content and container objects within the current container + content->GetEmbeddedObjectsL(array); + + // Do something with the array + .... + + // Finished + CleanupStack::PopAndDestroy(2); + @endcode + + @param aArray The array to be populated with the embedded objects. + @leave KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C void GetEmbeddedObjectsL(RStreamablePtrArray& aArray) const; + + /** List all the embedded objects within the current container that + are of the specified type + + @code + // Create a ccontent object for the file of interest + CContent* content = CContent::NewLC(uri); + + // Define an array to store the results + RStreamablePtrArray array; + CleanupClosePushL(array); + + // Find all the content objects within the current container + content->GetEmbeddedObjectsL(array, EContentObject); + + // Do something with the array + .... + + // Finished + CleanupStack::PopAndDestroy(2); + @endcode + + @param aArray The array to be populated with the embedded objects. + @param aType The type of objects to list. + @leave KErrPermissionDenied If the access to the protected content is not permitted by the CAF Agent. + @leave ... One of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C void GetEmbeddedObjectsL(RStreamablePtrArray& aArray, TEmbeddedType aType) const; + + /** Search the current container for content objects with a particular mime type + + @code + _LIT8(KTextPlainMimeType, "text/plain"); + + // Create a ccontent object for the file of interest + CContent* content = CContent::NewLC(uri); + + // Define an array to store the results + RStreamablePtrArray array; + CleanupClosePushL(array); + + // Recursively search for all the content objects with the + // specified mime type + User::LeaveIfError(content->Search(array, KTextPlainMimeType(), ETrue)); + + // Do something with the array + .... + + // Finished + CleanupStack::PopAndDestroy(2); + @endcode + + @param aArray The array to store the results of the search. The agent will add CEmbeddedObject objects to the supplied array. + @param aMimeType The mime type to search for. + @param aRecursive ETrue to search inside containers embedded within the current container, EFalse to search only the current container. + @return The result of the search. + @return KErrNone if the search was successful, even if no content objects were found. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt Search(RStreamablePtrArray& aArray, const TDesC8& aMimeType, TBool aRecursive); + + + /** Get an attribute for the default content object within the file + + @see ContentAccess::TAttribute + + @code + TInt value = 0; + CContent* c = CContent::NewL(uri); + TInt err =c->GetAttribute(EIsProtected, value); + if(err == KErrNone && value) + { + DisplayPadLock(); + } + @endcode + + @param aAttribute The attribute to query, from ContentAccess::TAttribute. + @param aValue Used to return the attribute value. + @return Whether the attribute value was updated. + @return KErrNone if the value of the attribute was updated. + @return KErrNotFound if the object with the given UniqueId was not found. + @return KErrCANotSupported if the requested attribute does not exist. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetAttribute(TInt aAttribute, TInt& aValue) const; + + /** Get an attribute for an object within the file + + @see ContentAccess::TAttribute + + @code + TInt value = 0; + CContent* c = CContent::NewL(uri); + TInt err =c->GetAttribute(EIsProtected, value, uniqueId); + if(err == KErrNone && value) + { + DisplayPadLock(); + } + @endcode + + @param aAttribute The attribute to query, from ContentAccess::TAttribute. + @param aValue Used to return the attribute value. + @param aUniqueId The UniqueId of the object within the file. + @return Whether the attribute value was updated. + @return KErrNone if the value of the attribute was updated. + @return KErrNotFound if the object with the given UniqueId was not found. + @return KErrCANotSupported if the requested attribute does not exist. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetAttribute(TInt aAttribute, TInt& aValue, const TDesC& aUniqueId) const; + + + /** Get a set of attributes for the default content object within the file + + @see ContentAccess::TAttribute + + The following example determines whether the default content object + is protected and has rights that will enable it to be viewed by the + user + + @code + CContent* content = CContent::NewLC(uri); + + RAttributeSet attributeSet; + CleanupClosePushL(attributeSet); + attributeSet->AddL(EProtected); + attributeSet->AddL(ECanView); + + User::LeaveIfError(content->GetAttributeSet(attributeSet); + + TInt err = attributeSet.GetValue(EProtected, value); + if(err == KErrNone && value) + { + // file is DRM protected + } + + err = attributeSet.GetValue(ECanView, value); + if(err == KErrNone && value) + { + // File has rights that allow it to be displayed on screen + } + + // Finished + CleanupStack::PopAndDestroy(2); // content, attributeSet.Close() + @endcode + + + @param aAttributeSet The set of attributes to query and update. + @return Whether the attribute set was updated. + @return KErrNone if the attributes were retrieved successfully. + @return KErrNotFound if the default content object was not found. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetAttributeSet(RAttributeSet& aAttributeSet) const; + + /** Get a set of attributes from an object within the file + + @see ContentAccess::TAttribute + + The following example determines whether the default content object + is protected and has rights that will enable it to be viewed by the + user + + @code + CContent* content = CContent::NewLC(uri); + + RAttributeSet attributeSet; + CleanupClosePushL(attributeSet); + attributeSet->AddL(EProtected); + attributeSet->AddL(ECanView); + + User::LeaveIfError(content->GetAttributeSet(attributeSet, uniqueId); + + TInt err = attributeSet.GetValue(EProtected, value); + if(err == KErrNone && value) + { + // file is DRM protected + } + + err = attributeSet.GetValue(ECanView, value); + if(err == KErrNone && value) + { + // File has rights that allow it to be displayed on screen + } + + // Finished + CleanupStack::PopAndDestroy(2); // content, attributeSet.Close() + @endcode + + + @param aAttributeSet The set of attributes to query and update. + @param aUniqueId The unique ID of the object within the file. + @return Whether that attribute set was updated. + @return KErrNone if the attributes were retrieved successfully. + @return KErrNotFound if the default content object was not found. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetAttributeSet(RAttributeSet& aAttributeSet, const TDesC& aUniqueId) const; + + /** Get text string attributes or meta-data for the default content object within the file + + @see ContentAccess::TStringAttribute + + @code + TInt err = KErrNone; + + CContent* c = CContent::NewL(uri); + TBuf previewUri; + err = c->GetStringAttribute(EPreviewURI, previewUri); + if(err == KErrNone) + { + DisplayPreview(previewUri); + } + @endcode + + @param aAttribute The attribute to query, from ContentAccess::TStringAttribute. + @param aValue Returns the value of the attribute. + @return Whether the attribute value was updated. + @return KErrNone if the attribute was retrieved. + @return KErrNotFound if the default content object was not found. + @return KErrOverflow if the buffer was not large enough to return the result. + @return KErrCANotSupported if the requested attribute does not exist. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetStringAttribute(TInt aAttribute, TDes& aValue) const; + + /** Get text string attributes or meta-data for an object within the file + + @see ContentAccess::TStringAttribute + + @code + TInt err = KErrNone; + + CContent* c = CContent::NewL(uri); + TBuf previewUri; + err = c->GetStringAttribute(EPreviewURI, previewUri, uniqueId); + if(err == KErrNone) + { + DisplayPreview(previewUri); + } + @endcode + + @param aAttribute The attribute to query, from ContentAccess::TStringAttribute. + @param aValue Returns the value of the attribute. + @param aUniqueId The UniqueId of the object within the file. + @return Whether the attribute value was updated. + @return KErrNone if the attribute was retrieved. + @return KErrNotFound if the object with the given UniqueId was not found. + @return KErrOverflow if the buffer was not large enough to return the result. + @return KErrCANotSupported if the requested attribute does not exist. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetStringAttribute(TInt aAttribute, TDes& aValue, const TDesC& aUniqueId) const; + + /** Obtain a set of string attributes for the default content object within the file + + @see ContentAccess::TStringAttribute + + @code + CContent* content = CContent::NewLC(uri); + + // create the attribute set, add the attributes we are interested in + RStringAttributeSet stringAttributeSet; + CleanupClosePushL(stringAttributeSet); + stringAttributeSet.AddL(EPreviewURI); + stringAttributeSet.AddL(ETitle); + + User::LeaveIfError(content->GetStringAttributeSet(stringAttributeSet)); + + // Pass the value of the string attribute to DisplayPreview() + TFileName previewUri; + TInt err = stringAttributeSet.GetValue(EPreviewURI, previewUri); + if(err == KErrNone) + { + DisplayPreview(previewUri); + } + + CleanupStack::PopAndDestroy(2); // content, stringAttributeSet.Close() + @endcode + + + @param aStringAttributeSet The set of attributes to query and update. + @return Whether the attribute set was updated. + @return KErrNone if the attributes were retrieved successfully. + @return KErrNotFound if the default content object was not found. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetStringAttributeSet(RStringAttributeSet& aStringAttributeSet) const; + + /** Used to obtain a set of string attributes for an object within the file + + @see ContentAccess::TStringAttribute + + @code + CContent* content = CContent::NewLC(uri); + + // create the attribute set, add the attributes we are interested in + RStringAttributeSet stringAttributeSet; + CleanupClosePushL(stringAttributeSet); + stringAttributeSet.AddL(EPreviewURI); + stringAttributeSet.AddL(ETitle); + + User::LeaveIfError(content->GetStringAttributeSet(stringAttributeSet, uniqueId)); + + // Pass the value of the string attribute to DisplayPreview() + TFileName previewUri; + TInt err = stringAttributeSet.GetValue(EPreviewURI, previewUri); + if(err == KErrNone) + { + DisplayPreview(previewUri); + } + + CleanupStack::PopAndDestroy(2); // content, stringAttributeSet.Close() + @endcode + + + @param aStringAttributeSet The set of attributes to query and update. + @param aUniqueId The UniqueId of the container or content. + @return Whether the attribute set was updated. + @return KErrNone if the attributes were retrieved successfully. + @return KErrNotFound if the object with the given UniqueId was not found. + @return KErrPermissionDenied if the access to the protected content is not permitted by the CAF Agent. + @return Otherwise one of the CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C TInt GetStringAttributeSet(RStringAttributeSet& aStringAttributeSet, const TDesC& aUniqueId) const; + + /** Allows extended synchronous calls to the CAF agent handling this file + + Applications familiar with the agent can pass objects in and out using serialization. + + @param aCommand The agent defined command. + @param aInputBuffer Non modifyable input data buffer. + @param aOutputBuffer Modifyable output buffer to hold the result of the command. + @return The outcome of the agent specific command. + @return KErrCANotSupported if the agent does not recognize the command. + @return KErrOverflow if the output buffer supplied is too small. + @return KErrPermissionDenied if the agent does not allow the client to execute the command. + @return Otherwise one of the other CAF error codes defined in \c caferr.h or one of the + other system-wide error codes for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt AgentSpecificCommand(TInt aCommand, const TDesC8& aInputBuffer, TDes8& aOutputBuffer); + + /** Allows extended synchronous calls to the CAF agent handling this file + Applications familiar with the agent can pass objects in and out using serialization. + NB: It is important that the descriptor passed to + aOutputBuffer remains in scope until the request has completed. + + @param aCommand The agent defined command. + @param aInputBuffer Non modifyable input data buffer. + @param aOutputBuffer Modifyable output buffer to hold the result of the command. + @param aStatus Asynchronous request status. On completion this will contain + one of the following error codes: + KErrNone if the command was successfully executed. + KErrCANotSupported if the agent does not recognize the command. + KErrOverflow if the output buffer supplied is too small. + KErrPermissionDenied if the agent does not allow the client + to execute the command. Otherwise one of the other CAF error codes defined + in \c caferr.h or one of the other system-wide error codes + for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C void AgentSpecificCommand(TInt aCommand, const TDesC8& aInputBuffer, TDes8& aOutputBuffer, TRequestStatus& aStatus); + + + /** Request notification for an event for the default content object within the file + + @see ContentAccess::TEventMask + + @param aMask Bitmask of events the caller is interested in. + @param aStatus The TRequestStatus object to complete if the event occurs. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C void NotifyStatusChange(TEventMask aMask, TRequestStatus& aStatus); + + /** Request notification for an event for an object within the file + + @see ContentAccess::TEventMask + + @param aMask Bitmask of events the caller is interested in. + @param aStatus The TRequestStatus object to complete if the event occurs. + @param aUniqueId The UniqueId of the container or content. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C void NotifyStatusChange(TEventMask aMask, TRequestStatus& aStatus, const TDesC& aUniqueId); + + /** Cancel a previous notification request for the default content object + + @param aStatus The TRequestStatus supplied in the call to NotifyStatusChange(). + @return The outcome of the cancel request. + @return KErrNone if the request was cancelled. + @return KErrNotFound if there was no matching request outstanding. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt CancelNotifyStatusChange(TRequestStatus& aStatus); + + /** Cancel a previous notification request + + @param aStatus The TRequestStatus supplied in the call to NotifyStatusChange(). + @param aUniqueId The UniqueId of the content object within the file. + @return The outcome of the cancel request. + @return KErrNone if the request was cancelled. + @return KErrNotFound if there was no matching request outstanding. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt CancelNotifyStatusChange(TRequestStatus& aStatus, const TDesC& aUniqueId); + + /** Request the agent to obtain rights for the default content object + + This request may be handled differently by different agents. + Some agents may open a browser and direct the user to a URL. Others may + download and install the rights in the background. + + The call should not block execution, applications can wait for a notification + if they are interested in the outcome. + + @param aStatus Asynchronous request status. On completion this will contain + one of the following error codes: + KErrNone if the rights request was successful. + KErrCANotSupported if the agent does not allow rights requests. + Otherwise one of the other CAF error codes defined in \c caferr.h + or one of the other system-wide error codes + for any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C void RequestRights(TRequestStatus& aStatus); + + /** Request the agent to obtain rights for a protected content object + + This request may be handled differently by different agents. + Some agents may open a browser and direct the user to a URL. Others may + download and install the rights in the background. + + The call should not block execution, applications can wait for a notification + if they are interested in the outcome. + + @param aStatus Asynchronous request status. On completion this will contain + one of the following error codes: + KErrNone if the rights request was successful. + KErrCANotSupported if the agent does not allow rights requests. + Otherwise one of the other CAF error codes defined in \c caferr.h + or one of the other system-wide error codes + for any other errors. + + @param aUniqueId The unique id of the object within the file. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C void RequestRights(TRequestStatus& aStatus, const TDesC& aUniqueId); + + + /** Cancel a previous RequestRights() request for the default content object + + @param aStatus The TRequestStatus that was supplied to the RequestRights() function. + @return The result of the cancel rights request. + @return KErrNone if the rights request was cancelled. + @return KErrNotFound if there was no matching rights request outstanding. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt CancelRequestRights(TRequestStatus& aStatus); + + /** Cancel a previous RequestRights() request + + @param aStatus The TRequestStatus that was supplied to the RequestRights() function. + @param aUniqueId The objects Unique Id that was supplied to the RequestRights() function. + @return The result of the cancel rights request. + @return KErrNone if the rights request was cancelled. + @return KErrNotFound if there was no matching rights request outstanding. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt CancelRequestRights(TRequestStatus& aStatus, const TDesC& aUniqueId); + + /** View information associated with the default content object + + This call blocks execution and only returns once the display is dismissed + by the user. + + @see ContentAccess::TDisplayInfo + + @param aInfo The information to display. + @leave KErrCANotSupported if information cannot be displayed or does not exist. + @leave ... One of the other CAF error codes defined in \c caferr.h + or one of the system-wide error codes for + any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C void DisplayInfoL(TDisplayInfo aInfo) const; + + /** View information associated with a single content object + + This call blocks execution and only returns once the display is dismissed + by the user. + + @see ContentAccess::TDisplayInfo + + @param aInfo The information to display. + @param aUniqueId The unique id of the object within the file. + @leave KErrCANotSupported if information cannot be displayed or does not exist. + @leave ... One of the other CAF error codes defined in \c caferr.h + or one of the system-wide error codes for + any other errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C void DisplayInfoL(TDisplayInfo aInfo, const TDesC& aUniqueId) const; + + + /** Request the agent handling this content to set a property value. If + the property is set it is only set for this CContent session and does not + impact other CAF users and is not set for CData products created by the + CContent. + + @see ContentAccess::TAgentProperty + + @param aProperty The property to set. + @param aValue The value of the property. + @return Whether the property was set. + @return KErrNone if the property was set. + @return KErrCANotSupported if the agent does not support the property or value. + @return KErrAccessDenied if the agent does not permit the property to be changed. + @return KErrPermissionDenied if the application does not have the necessary capability to change the property. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C TInt SetProperty(TAgentProperty aProperty, TInt aValue); + + /** + Grants read access to the default content object based on + evaluation of the supplied intent information. + + Note that the intent is simply evaluated and not executed. + To force the intent to be executed, clients must use the call + ContentAccess::CData::ExecuteIntent(). + + A CData object can be obtained as follows: + @code + CData* MyData = myContent->OpenContentL(ChosenIntent); + ... + delete MyData; // when finished accessing plaintext content + @endcode + + @see ContentAccess::TIntent + + @param aIntent The intent indicator. + @return A CData instance. The caller gets ownership of this object. + + @leave KErrNotFound The content object with the given UniqueId does not exist. + @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. + @leave KErrCANoPermission Rights exist but the specified intent is not permitted. + @leave KErrCANoRights No rights exist for the content object. + @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. + @leave KErrPermissionDenied The agent does not allow the client to access the content object. + @leave KErrAccessDenied The content is already in use. + @leave ... One of the other CAF error codes defined in \c caferr.h + or one of the other system-wide error codes for any other + errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C CData* OpenContentL(TIntent aIntent); + + /** + Grants read access to the default content object based on + evaluation of the supplied intent information. + + Note that the intent is simply evaluated and not executed. + To force the intent to be executed, clients must use the call + ContentAccess::CData::ExecuteIntent(). + + A CData object can be obtained as follows: + @code + CData* myData = myContent->OpenContentLC(ChosenIntent); + ... + // when finished accessing plaintext content + CleanupStack::PopAndDestroy(myData); + @endcode + + @see ContentAccess::TIntent + + @param aIntent The intent indicator. + @return A CData instance. The caller gets ownership of this object. + + @leave KErrNotFound The content object with the given UniqueId does not exist. + @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. + @leave KErrCANoPermission Rights exist but the specified intent is not permitted. + @leave KErrCANoRights No rights exist for the content object. + @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. + @leave KErrPermissionDenied The agent does not allow the client to access the content object. + @leave KErrAccessDenied The content is already in use. + @leave ... One of the other CAF error codes defined in \c caferr.h + or one of the other system-wide error codes for any other + errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted. + */ + IMPORT_C CData* OpenContentLC(TIntent aIntent); + + /** + Grants read access to the content object based on evaluation of the + supplied intent information. + + Note that the intent is simply evaluated and not executed. + To force the intent to be executed, clients must use the call + ContentAccess::CData::ExecuteIntent(). + + A CData object can be obtained as follows: + @code + CData* MyData = myContent->OpenContentL(ChosenIntent, uniqueId); + ... + delete MyData; // when finished accessing plaintext content + @endcode + + @see ContentAccess::TIntent + + @param aIntent The intent indicator. + @param aUniqueId The object to open for reading. If the UniqueId is set to KNullDesC16() the entire file will be opened for reading with no transformation. + @return A CData instance. The caller gets ownership of this object. + + @leave KErrNotFound The content object with the given UniqueId does not exist. + @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. + @leave KErrCANoPermission Rights exist but the specified intent is not permitted. + @leave KErrCANoRights No rights exist for the content object. + @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. + @leave KErrPermissionDenied The agent does not allow the client to access the content object. + @leave KErrAccessDenied The content is already in use. + @leave ... One of the other CAF error codes defined in \c caferr.h + or one of the other system-wide error codes for any other + errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C CData* OpenContentL(TIntent aIntent, const TDesC& aUniqueId); + + + /** + Grants read access to the content object based on evaluation of the + supplied intent information. + + Note that the intent is simply evaluated and not executed. + To force the intent to be executed, clients must use the call + ContentAccess::CData::ExecuteIntent(). + + A CData object can be obtained as follows: + @code + CData* MyData = myContent->OpenContentLC(ChosenIntent, uniqueId); + ... + PopAndDestroy(MyData); // when finished accessing plaintext content + @endcode + + @see ContentAccess::TIntent + + @param aIntent The intent indicator. + @param aUniqueId The object to open for reading. If the UniqueId is set to KNullDesC16() the entire file will be opened for reading with no transformation. + @return A CData instance. The caller gets ownership of this object. + + @leave KErrNotFound The content object with the given UniqueId does not exist. + @leave KErrCAPendingRights The rights have not yet arrived but are expected soon. + @leave KErrCANoPermission Rights exist but the specified intent is not permitted. + @leave KErrCANoRights No rights exist for the content object. + @leave KErrCANotSupported Unable to open the object with the specified UniqueId, it may be a container object. + @leave KErrPermissionDenied The agent does not allow the client to access the content object. + @leave KErrAccessDenied The content is already in use. + @leave ... One of the other CAF error codes defined in \c caferr.h + or one of the other system-wide error codes for any other + errors. + @capability DRM Access to DRM protected content is not permitted for processes without DRM capability. Access to unprotected content is unrestricted + */ + IMPORT_C CData* OpenContentLC(TIntent aIntent, const TDesC& aUniqueId); + + + /** Find out which agent is handling this file + @return The agent handling the File + */ + IMPORT_C const TAgent& Agent() const; + +#ifndef REMOVE_CAF1 + /** Create a CData object for reading the content + + @see ContentAccess::TIntent + @param aIntent The intended use of the content + @param aShareMode The mode used to open the file. If EContentShareExclusive is required, use CData::NewL() instead + @return A new CData object + @leave One of the CAF error codes defined in \c caferr.h or one of the system-wide error codes for any errors. + @capability DRM Access to DRM agents is not permitted for processes without DRM capability + @deprecated + */ + IMPORT_C CData* OpenContentL(TIntent aIntent, TContentShareMode aShareMode); + + /** Create a CAttribute object to determine the attributes of the default content object + + @return The agent handling the File + @capability DRM Access to DRM agents is not permitted for processes without DRM capability + @deprecated + */ + IMPORT_C CAttribute* NewAttributeL(TBool aPreloaded); + + /** Create a CAttribute object to determine the attributes of the default content object + + @return The agent handling the File + @capability DRM Access to DRM agents is not permitted for processes without DRM capability + @deprecated + */ + IMPORT_C CAttribute* NewAttributeL(TBool aPreloaded, TContentShareMode aShareMode); + +#endif // REMOVE_CAF1 + + private: + CContent(); + void ConstructL(RFile& aFile); + void ConstructL(const TDesC& aURI, TContentShareMode aShareMode); + + private: + + /** CAgentFactory object is effectively the ECOM session handle */ + CAgentFactory* iAgentFactory; + + /** + Agent object used for browsing the contents of a file + */ + CAgentContent* iAgentContent; + + /** Points to the default content object if the file is opened by name */ + CVirtualPath* iVirtualPath; + + /** The content object referred to by CContent, either points to iVirtualPath + or points to (KNullDesC(), KDefaultContentObject()) + */ + TVirtualPathPtr iDefaultVirtualPath; + + /* Stores the name and UID of the agent + */ + TAgent iAgent; + + /** The share mode used to open the content file*/ + TContentShareMode iShareMode; + + /** Reference to the file handle if the content was opened with a file handle */ +#ifdef SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API + RFile64 iFile; +#else + RFile iFile; +#endif //SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API + }; + + } // namespace ContentAccess +#endif /* __CONTENT_H__ */