--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/contentmgmt/contentaccessfwfordrm/inc/attribute.h	Wed Jul 08 11:25:26 2009 +0100
@@ -0,0 +1,152 @@
+/*
+* 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__