/*

 * Copyright (c) 2002-2005 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 * which accompanies this distribution, and is available

 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 *

 * Initial Contributors:

 * Nokia Corporation - initial contribution.

 *

 * Contributors:

 *

 * Description: Service policy interface for serene   

 *

 */

 #ifndef M_SEN_SERVICE_POLICY_H

 #define M_SEN_SERVICE_POLICY_H

 //  INCLUDES

 #include <e32base.h> // for CActive

 #include <badesca.h>

 #include "SenDomFragment.h"

 typedef RPointerArray<CSenElement> RPolicyArray;

 // FORWARD DECLARATION

 // CLASS DECLARATION

 /*

 *   <ServicePolicy>

 *       <ClientPolicy>

 *			<MetadataEndpoint>uri.1</MetadataEndpoint>

 *			<MetadataEndpoint>uri.2</MetadataEndpoint>

 *			<MetadataEndpoint>uri.3</MetadataEndpoint>

 *           <PolicyValue1/>				

 *           <PolicyValue2/>				

 *       </ClientPolicy>

 *       <PolicyArrray>

 *			<wsp:Policy1/>

 *			<wsp:Policy2/>

 *       </PolicyArrray>

 *   </ServicePolicy>

 */

 class MSenServicePolicy

     {

     public: // New functions

         /**

         * Adds a policy in SD

         * Method is used to add a RAW policy obtained 

         * by Network or some dynamic means

         * @since Series60 4.0

         * @param aPolicy is the Policy Element

         */ 

         virtual TInt AddPolicyL(CSenElement* aPolicy) = 0;

         /**

         * Remove  a Policy from SD

         * @param aPolicyName , Policy with this name will be removed from SD

         * @return

         *  - KErrNone 

         */ 

         virtual TInt RemovePolicyL(TDesC8& aPolicyName) = 0;

         /**

         * Method reads provider policy class instance values from given

         * template. 

         * @since Series60 4.0

         * @param aTemplate from which the values are read.

         * @return   

         *           

         */ 

         virtual TInt RebuildServicePolicyFrom(MSenServicePolicy& aTemplate) = 0;

         /**

         * Checks if policies match.

         * @return ETrue if policies match, EFalse if not.

         */

         virtual TBool Accepts(MSenServicePolicy& aPolicyPattern) = 0;

         /**

         * Getter for ServicePolicies

         * @since Series60 4.0

         * @return 

         *           

         */ 

 		/**

 		* Return all of the Services polices from SD only <wsp:Policy> tags

 		* @param aPolicies

 		* @return KErrNone

 		*		  KErrNotFound	

 		*/

         virtual TInt ServicePolicies(RPolicyArray& aPolicies) = 0;

         /**

         * Gets the Client Policy

         */

         virtual CSenElement* ClientPolicy() = 0;

         /**

         * Searches for the Client Policy with the given key value

         * @param aKey

         * @return ETrue If the Client Policy is present with the given key value

         *		  EFalse If the Client Policy is not present with the given key value  

         */

         virtual TBool ClientPolicy(const TDesC8& aKey) = 0;

         /**

         * Gets the Client Policy with the given key value

         * @param aKey

         * @return Client Policy Value is returned

         */

         virtual HBufC8* ClientPolicyValue(const TDesC8& aKey) = 0;

     };

 #endif //M_SEN_POLICY_H

 // End of File