1 /*

     2 * Copyright (c) 2008-2008 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Provides access to service provider settings

    15 *

    16 */

    17 

    18 

    19 #ifndef C_CCHUISPSHANDLER_H

    20 #define C_CCHUISPSHANDLER_H

    21 

    22 #include <e32base.h>

    23 #include <e32const.h>

    24 

    25 class CSPSettings;

    26 

    27 /**

    28  * Service provider settings handler.

    29  * This class implements the use of Service provider settings.

    30  *

    31  * @code

    32  *  CCchUiSpsHandler* spsHandler = CCchUiSpsHandler::NewLC();

    33  *  spsHandler->SetTemporaryIapIdL( aServiceId, aIapId );

    34  *  CleanupStack::PopAndDestroy( spsHandler );

    35  * @endcode

    36  *

    37  * @lib cchui.lib

    38  * @since S60 5.0

    39  */

    40 NONSHARABLE_CLASS( CCchUiSpsHandler ): public CBase

    41     {

    42 public:

    43     

    44     /**

    45      * Two-phased constructor.

    46      */

    47     static CCchUiSpsHandler* NewL();

    48     

    49     /**

    50      * Two-phased constructor.

    51      */

    52     static CCchUiSpsHandler* NewLC();

    53 

    54     /**

    55      * Destructor.

    56      */

    57     virtual ~CCchUiSpsHandler();

    58       

    59     /**

    60      * Sets temporary iap id for the sevice.

    61      *

    62      * @since S60 5.0

    63      * @param aServiceId Service id.

    64      * @param aIapId Iap id to be set.

    65      */

    66     void SetTemporaryIapIdL( 

    67         TUint32 aServiceId, 

    68         TUint32 aIapId );

    69     

    70     /**

    71      * Sets SNAP id for specific service.

    72      *

    73      * @since S60 5.0

    74      * @param aServiceId Service id.

    75      * @param aSnapId Snap id to be set.

    76      */

    77     void SetSnapIdL( 

    78         TUint32 aServiceId,

    79         TUint32 aSnapId );    

    80 

    81     /**

    82      * Resolves service name.

    83      *

    84      * @since S60 5.0

    85      * @param aServiceId Service id.

    86      * @param aServiceName, will store service name

    87      */

    88     void ServiceNameL( 

    89         TUint32 aServiceId, 

    90         TDes& aServiceName );

    91 

    92 private:

    93 

    94     CCchUiSpsHandler();

    95     

    96     void ConstructL();

    97 

    98 private: // data

    99 

   100     /**

   101      * Service provider settings.

   102      * Own.

   103      */

   104     CSPSettings* iSettings;

   105     };

   106 

   107 #endif // C_CCHUISPSHANDLER_H