1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/epoc32/include/mw/msencobrandinginterface.h	Wed Mar 31 12:33:34 2010 +0100
     1.3 @@ -0,0 +1,57 @@
     1.4 +/*
     1.5 +* Copyright (c) 2002-2007 Nokia Corporation and/or its subsidiary(-ies).
     1.6 +* All rights reserved.
     1.7 +* This component and the accompanying materials are made available
     1.8 +* under the terms of "Eclipse Public License v1.0"
     1.9 +* which accompanies this distribution, and is available
    1.10 +* at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.11 +*
    1.12 +* Initial Contributors:
    1.13 +* Nokia Corporation - initial contribution.
    1.14 +*
    1.15 +* Contributors:
    1.16 +*
    1.17 +* Description:           Callback interface for co-branding interface.
    1.18 +*
    1.19 +*/
    1.20 +
    1.21 +
    1.22 +
    1.23 +
    1.24 +#ifndef M_SEN_COBRANDING_INTERFACE_H
    1.25 +#define M_SEN_COBRANDING_INTERFACE_H
    1.26 +
    1.27 +// CLASS DECLARATION
    1.28 +/**
    1.29 + * Callback interface for co-branding.
    1.30 + * Note: UID for this interface is KSenInterfaceUidCoBrandingObserver.
    1.31 + *
    1.32 + * Application that wishes to enable billing also needs to enable
    1.33 + * following properties of client policy by calling
    1.34 + * CSenXmlServiceDescription::SetPolicy( const TDesC8& aName, const TDesC8& aValue ):
    1.35 + *
    1.36 + *  - Application Info      [ <AppInfo/>,       KSenLocalnameAppInfo ]
    1.37 + *  - WAP gateway address   [ <WAPGW"/>,        KSenLocalnameWAPGW   ] 
    1.38 + *  - MWS namespace         [ <MwsNamespace/>,  KSenLocalnameMwsNamespace   ]
    1.39 + *
    1.40 + * If application does not provide WAP GW address as part of client policy,
    1.41 + * it signalizes that application wants to skip communication with WAP GW
    1.42 + * and talk directly with billing gateway instead. Typically, this depends
    1.43 + * on operator spesific environment.
    1.44 + */
    1.45 +class MSenCoBrandingObserver
    1.46 +    {
    1.47 +    public:
    1.48 +    /**
    1.49 +    * This method is called when list of co-branding IDs is receieved during authentication.
    1.50 +    * @param aBrandIdListAsXmlSnippet is the list of brand IDs in form of XML snippet
    1.51 +    * @param aSelectedBrandId is supposed to point to the brand ID selected by the application
    1.52 +    * when this callback returns.
    1.53 +    * @return TBool indicates whether or not the application wants to proceed (enable)
    1.54 +    * the use of billing ecosystem or stop the whole progress.
    1.55 +    */
    1.56 +    virtual TBool OnGetBrandIdL(  const TDesC8& aBrandIdListAsXmlSnippet, RBuf8& aSelectedBrandId) = 0;
    1.57 +    };
    1.58 +#endif // M_SEN_COBRANDING_INTERFACE_H
    1.59 +
    1.60 +// End of File