websrv_pub/web_service_connection_api/inc/msencobrandinginterface.h
changeset 0 62f9d29f7211
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/websrv_pub/web_service_connection_api/inc/msencobrandinginterface.h	Thu Jan 07 16:19:19 2010 +0200
@@ -0,0 +1,57 @@
+/*
+* Copyright (c) 2002-2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "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:           Callback interface for co-branding interface.
+*
+*/
+
+
+
+
+#ifndef M_SEN_COBRANDING_INTERFACE_H
+#define M_SEN_COBRANDING_INTERFACE_H
+
+// CLASS DECLARATION
+/**
+ * Callback interface for co-branding.
+ * Note: UID for this interface is KSenInterfaceUidCoBrandingObserver.
+ *
+ * Application that wishes to enable billing also needs to enable
+ * following properties of client policy by calling
+ * CSenXmlServiceDescription::SetPolicy( const TDesC8& aName, const TDesC8& aValue ):
+ *
+ *  - Application Info      [ <AppInfo/>,       KSenLocalnameAppInfo ]
+ *  - WAP gateway address   [ <WAPGW"/>,        KSenLocalnameWAPGW   ] 
+ *  - MWS namespace         [ <MwsNamespace/>,  KSenLocalnameMwsNamespace   ]
+ *
+ * If application does not provide WAP GW address as part of client policy,
+ * it signalizes that application wants to skip communication with WAP GW
+ * and talk directly with billing gateway instead. Typically, this depends
+ * on operator spesific environment.
+ */
+class MSenCoBrandingObserver
+    {
+    public:
+    /**
+    * This method is called when list of co-branding IDs is receieved during authentication.
+    * @param aBrandIdListAsXmlSnippet is the list of brand IDs in form of XML snippet
+    * @param aSelectedBrandId is supposed to point to the brand ID selected by the application
+    * when this callback returns.
+    * @return TBool indicates whether or not the application wants to proceed (enable)
+    * the use of billing ecosystem or stop the whole progress.
+    */
+    virtual TBool OnGetBrandIdL(  const TDesC8& aBrandIdListAsXmlSnippet, RBuf8& aSelectedBrandId) = 0;
+    };
+#endif // M_SEN_COBRANDING_INTERFACE_H
+
+// End of File