contentmgmt/contentaccessfwfordrm/inc/attribute.h
changeset 8 35751d3474b7
parent 0 2c201484c85f
child 15 da2ae96f639b
--- a/contentmgmt/contentaccessfwfordrm/inc/attribute.h	Tue Jul 21 01:04:32 2009 +0100
+++ b/contentmgmt/contentaccessfwfordrm/inc/attribute.h	Thu Sep 10 14:01:51 2009 +0300
@@ -1,152 +1,151 @@
-/*
-* Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
-* All rights reserved.
-* This component and the accompanying materials are made available
-* under the terms of the License "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
- @deprecated
-*/
-
-#ifndef __CAF_ATTRIBUTE_H__
-#define __CAF_ATTRIBUTE_H__
-
-#ifndef REMOVE_CAF1
-
-#include <e32base.h>
-#include <f32file.h>
-#include <caf/caftypes.h>
-
-
-namespace ContentAccess
-{
-	class CAgentContent;
-	class CAgentFactory;
-	class CBitset;
-	
-	/**
-	 * Encapsulates the attributes of a piece of content. 
-	 *
-	 * These attributes will be required by DRM-aware
-	 * applications in order that they can uphold DRM policies in a
-	 * well-behaved manner. In general, clients set one or more attributes
-	 * in the <i>Query</i> set, make a <i>GetL</i> call, and then
-	 * read the agent's reponse from the <i>Response</i> set.
-	 *
-	 * CAttribute is a container for a number of separate
-	 * ContentAccess::CBitset objects. These individual bitsets contain:
-	 * -# Queries - what the client is interested in knowing.
-	 * -# Responses - the answers to the queries.
-	 * -# Capabilities - which attributes the system is able to support.
-	 *
-	 * Access to the bitset operations themselves can be achieved via the
-	 * ContentAccess::CAttribute::AttributeSetL operation.
-	 *
-	 * @publishedPartner
-	 * @deprecated 
-	 */
-	class CAttribute : public CBase
-		{
-	public:
-		/**
-		 Constructs a new attribute given an agent and file handle.
-		 
-		 @param aAgentUid	The agent Uid
-		 @param aFile		A file handle 
-		 @return			The new CAttribute.
-		 
-		 @internalComponent
-		 @released		 
-		 */
-		static CAttribute* NewLC(TUid aAgentUid, RFile& aFile);
-		
-		/**
-		 Constructs a new attribute given an agent and content.
-		 
-		 @param aAgentUid	The agent Uid
-		 @param aURI		The pathname of the target content.
-		 @param aShareMode Optional share mode for opening attributes of this content, defaults to EContentShareReadOnly. This parameter has no effect unless the content is a local file on the device.
-		 @return			The new CAttribute.
-		 
-		 @internalComponent
-		 @released
-		 */
-		static CAttribute* NewLC(TUid aAgentUid, const TDesC& aURI, TContentShareMode aShareMode=EContentShareReadOnly);
-
-		
-		virtual ~CAttribute();
-
-		/**
-		 * Returns a reference to the query set
-		 *
-		 * The bits of the query-set should be set or cleared prior to the "GetL()" 
-		 * call to specify which attributes the client is interested in.
-		 *
-		 * @note	Set is probably best used inline to access some of the 
-		 * 			CBitset operations directly.
-		 * 			@code 
-		 * 			// Set EIsProtected in the Query set.
-		 * 			MyAttr->QuerySet(EQuerySet).Set(EIsProtected);
-		 * 			@endcode
-		 *
-		 * @return	A CBitset refererence.
-		 */
-		IMPORT_C CBitset& QuerySet();
-
-		/**
-		 * Returns a reference to the response set. 
-		 * 
-		 * The response set will only be valid after a call to the "GetL()" operation.
-		 *
-		 * @return	A CBitset refererence.
-		 */
-		IMPORT_C const CBitset& ResponseSet() const;
-		
-		/**
-		 * Resets the attribute object completely. 
-		 */ 
-		IMPORT_C void Reset();
-		
-		/**
-		 * Delivers the attribute object to the relevant agent for
-		 * querying. 
-		 * 
-		 * The agent will set or reset the ResponseSet() bits for any QuerySet() bits 
-		 * that are set
-		 */
-		IMPORT_C void GetL();
-		
-	private:
-		void ConstructL(TUid aAgentUid, RFile& aFile);
-		void ConstructL(TUid aAgentUid, const TDesC& aURI, TContentShareMode aShareMode=EContentShareReadOnly);
-		CAttribute();
-				
-	private:
-		/** The real object used to retrieve attributes. */
-		CAgentContent* iAgentContent;
-		CAgentFactory* iAgentFactory;
-
-		CBitset* iQuerySet;
-		CBitset* iResponseSet;
-		};
-	}
-
-#endif // REMOVE_CAF1
-
-#endif // __ATTRIBUTE_H__
+/*
+* Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of the License "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
+ @deprecated
+*/
+
+#ifndef __CAF_ATTRIBUTE_H__
+#define __CAF_ATTRIBUTE_H__
+
+#ifndef REMOVE_CAF1
+
+#include <e32base.h>
+#include <f32file.h>
+#include <caf/caftypes.h>
+
+
+namespace ContentAccess
+{
+	class CAgentContent;
+	class CAgentFactory;
+	class CBitset;
+	
+	/**
+	 * Encapsulates the attributes of a piece of content. 
+	 *
+	 * These attributes will be required by DRM-aware
+	 * applications in order that they can uphold DRM policies in a
+	 * well-behaved manner. In general, clients set one or more attributes
+	 * in the <i>Query</i> set, make a <i>GetL</i> call, and then
+	 * read the agent's reponse from the <i>Response</i> set.
+	 *
+	 * CAttribute is a container for a number of separate
+	 * ContentAccess::CBitset objects. These individual bitsets contain:
+	 * -# Queries - what the client is interested in knowing.
+	 * -# Responses - the answers to the queries.
+	 * -# Capabilities - which attributes the system is able to support.
+	 *
+	 * Access to the bitset operations themselves can be achieved via the
+	 * ContentAccess::CAttribute::AttributeSetL operation.
+	 *
+	 * @publishedPartner
+	 * @deprecated 
+	 */
+	class CAttribute : public CBase
+		{
+	public:
+		/**
+		 Constructs a new attribute given an agent and file handle.
+		 
+		 @param aAgentUid	The agent Uid
+		 @param aFile		A file handle 
+		 @return			The new CAttribute.
+		 
+		 @internalComponent
+		 @released		 
+		 */
+		static CAttribute* NewLC(TUid aAgentUid, RFile& aFile);
+		
+		/**
+		 Constructs a new attribute given an agent and content.
+		 
+		 @param aAgentUid	The agent Uid
+		 @param aURI		The pathname of the target content.
+		 @param aShareMode Optional share mode for opening attributes of this content, defaults to EContentShareReadOnly. This parameter has no effect unless the content is a local file on the device.
+		 @return			The new CAttribute.
+		 
+		 @internalComponent
+		 @released
+		 */
+		static CAttribute* NewLC(TUid aAgentUid, const TDesC& aURI, TContentShareMode aShareMode=EContentShareReadOnly);
+
+		
+		virtual ~CAttribute();
+
+		/**
+		 * Returns a reference to the query set
+		 *
+		 * The bits of the query-set should be set or cleared prior to the "GetL()" 
+		 * call to specify which attributes the client is interested in.
+		 *
+		 * @note	Set is probably best used inline to access some of the 
+		 * 			CBitset operations directly.
+		 * 			@code 
+		 * 			// Set EIsProtected in the Query set.
+		 * 			MyAttr->QuerySet(EQuerySet).Set(EIsProtected);
+		 * 			@endcode
+		 *
+		 * @return	A CBitset refererence.
+		 */
+		IMPORT_C CBitset& QuerySet();
+
+		/**
+		 * Returns a reference to the response set. 
+		 * 
+		 * The response set will only be valid after a call to the "GetL()" operation.
+		 *
+		 * @return	A CBitset refererence.
+		 */
+		IMPORT_C const CBitset& ResponseSet() const;
+		
+		/**
+		 * Resets the attribute object completely. 
+		 */ 
+		IMPORT_C void Reset();
+		
+		/**
+		 * Delivers the attribute object to the relevant agent for
+		 * querying. 
+		 * 
+		 * The agent will set or reset the ResponseSet() bits for any QuerySet() bits 
+		 * that are set
+		 */
+		IMPORT_C void GetL();
+		
+	private:
+		void ConstructL(TUid aAgentUid, RFile& aFile);
+		void ConstructL(TUid aAgentUid, const TDesC& aURI, TContentShareMode aShareMode=EContentShareReadOnly);
+		CAttribute();
+				
+	private:
+		/** The real object used to retrieve attributes. */
+		CAgentContent* iAgentContent;
+		CAgentFactory* iAgentFactory;
+
+		CBitset* iQuerySet;
+		CBitset* iResponseSet;
+		};
+	}
+
+#endif // REMOVE_CAF1
+
+#endif // __ATTRIBUTE_H__
+