williamr@4: /*
williamr@4: * Copyright (c) 2002-2007 Nokia Corporation and/or its subsidiary(-ies).
williamr@4: * All rights reserved.
williamr@4: * This component and the accompanying materials are made available
williamr@4: * under the terms of "Eclipse Public License v1.0"
williamr@4: * which accompanies this distribution, and is available
williamr@4: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@4: *
williamr@4: * Initial Contributors:
williamr@4: * Nokia Corporation - initial contribution.
williamr@4: *
williamr@4: * Contributors:
williamr@4: *
williamr@4: * Description:           Callback interface for co-branding interface.
williamr@4: *
williamr@4: */
williamr@4: 
williamr@4: 
williamr@4: 
williamr@4: 
williamr@4: #ifndef M_SEN_COBRANDING_INTERFACE_H
williamr@4: #define M_SEN_COBRANDING_INTERFACE_H
williamr@4: 
williamr@4: // CLASS DECLARATION
williamr@4: /**
williamr@4:  * Callback interface for co-branding.
williamr@4:  * Note: UID for this interface is KSenInterfaceUidCoBrandingObserver.
williamr@4:  *
williamr@4:  * Application that wishes to enable billing also needs to enable
williamr@4:  * following properties of client policy by calling
williamr@4:  * CSenXmlServiceDescription::SetPolicy( const TDesC8& aName, const TDesC8& aValue ):
williamr@4:  *
williamr@4:  *  - Application Info      [ <AppInfo/>,       KSenLocalnameAppInfo ]
williamr@4:  *  - WAP gateway address   [ <WAPGW"/>,        KSenLocalnameWAPGW   ] 
williamr@4:  *  - MWS namespace         [ <MwsNamespace/>,  KSenLocalnameMwsNamespace   ]
williamr@4:  *
williamr@4:  * If application does not provide WAP GW address as part of client policy,
williamr@4:  * it signalizes that application wants to skip communication with WAP GW
williamr@4:  * and talk directly with billing gateway instead. Typically, this depends
williamr@4:  * on operator spesific environment.
williamr@4:  */
williamr@4: class MSenCoBrandingObserver
williamr@4:     {
williamr@4:     public:
williamr@4:     /**
williamr@4:     * This method is called when list of co-branding IDs is receieved during authentication.
williamr@4:     * @param aBrandIdListAsXmlSnippet is the list of brand IDs in form of XML snippet
williamr@4:     * @param aSelectedBrandId is supposed to point to the brand ID selected by the application
williamr@4:     * when this callback returns.
williamr@4:     * @return TBool indicates whether or not the application wants to proceed (enable)
williamr@4:     * the use of billing ecosystem or stop the whole progress.
williamr@4:     */
williamr@4:     virtual TBool OnGetBrandIdL(  const TDesC8& aBrandIdListAsXmlSnippet, RBuf8& aSelectedBrandId) = 0;
williamr@4:     };
williamr@4: #endif // M_SEN_COBRANDING_INTERFACE_H
williamr@4: 
williamr@4: // End of File