diff -r e1b950c65cb4 -r 837f303aceeb epoc32/include/mw/msencobrandinginterface.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/epoc32/include/mw/msencobrandinginterface.h Wed Mar 31 12:33:34 2010 +0100 @@ -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 [ , KSenLocalnameAppInfo ] + * - WAP gateway address [ , KSenLocalnameWAPGW ] + * - MWS namespace [ , 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