phonesrv_plat/ss_settings_api/inc/RCustomerServiceProfileCache.h
changeset 46 2fa1fa551b0b
parent 42 35488577e233
child 48 78df25012fda
equal deleted inserted replaced
42:35488577e233 46:2fa1fa551b0b
     1 /*
       
     2 * Copyright (c) 2002-2005 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:  Customer service profile cache
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 #ifndef RCUSTOMERSERVICEPROFILECACHE_H
       
    20 #define RCUSTOMERSERVICEPROFILECACHE_H
       
    21 
       
    22 //  INCLUDES
       
    23 #include <etelmm.h>
       
    24 #include <e32property.h>           // RProperty.
       
    25 
       
    26 
       
    27 // FORWARD DECLARATIONS
       
    28 class RProperty;
       
    29 
       
    30 // CLASS DECLARATION
       
    31 
       
    32 /**
       
    33 * Customer service profile cache
       
    34 * @since    1.0
       
    35 * @lib      SsSettings.lib
       
    36 */
       
    37 class RCustomerServiceProfileCache
       
    38     {
       
    39     public: // Constructor and destructor
       
    40         IMPORT_C RCustomerServiceProfileCache();
       
    41         IMPORT_C ~RCustomerServiceProfileCache();
       
    42 
       
    43     public: // New functions
       
    44         //Settings categories
       
    45         enum TSsGroups
       
    46             {
       
    47             ESsCspGroup1, // contains Call Offering, Call Restriction,
       
    48                           // Call Completion and Teleservices
       
    49             ESsCspGroup2  // contains Value Added Services
       
    50             };
       
    51 
       
    52         /**
       
    53         * Opens connections. Must be done before fetching any items.
       
    54         * @return Error code.
       
    55         */
       
    56         IMPORT_C TInt Open();
       
    57 
       
    58         /**
       
    59         * Closes connections.
       
    60         */
       
    61         IMPORT_C void Close();
       
    62 
       
    63         /**
       
    64         * Get call completion flags from CSP.
       
    65         * @param aParams Call completion parameters.
       
    66         * @return Error code.
       
    67         */
       
    68         IMPORT_C TInt CspCallCompletion( 
       
    69             RMobilePhone::TCspCallCompletion& aParams );
       
    70 
       
    71         /**
       
    72         * Get call offering flags from CSP.
       
    73         * @param aParams Call offering parameters.
       
    74         * @return Error code.
       
    75         */
       
    76         IMPORT_C TInt CspCallOffering( 
       
    77             RMobilePhone::TCspCallOffering& aParams );
       
    78 
       
    79         /**
       
    80         * Get call restriction flags from CSP.
       
    81         * @param aParams Call restriction parameters.
       
    82         * @return Error code.
       
    83         */
       
    84         IMPORT_C TInt CspCallRestriction( 
       
    85             RMobilePhone::TCspCallRestriction& aParams );
       
    86 
       
    87         /**
       
    88         * Get CPHS tele services flags from CSP.
       
    89         * @param aParams Tele services parameters.
       
    90         * @return Error code.
       
    91         */
       
    92         IMPORT_C TInt CspCPHSTeleservices( 
       
    93             RMobilePhone::TCspCPHSTeleservices& aParams );
       
    94 
       
    95         /**
       
    96         * Handles refresh.
       
    97         * @return Error code.
       
    98         */
       
    99         IMPORT_C TInt HandleRefresh();
       
   100 
       
   101         /**
       
   102         * Get value added services flags from CSP.
       
   103         * @since 1.2.
       
   104         * @param aParams Value added services parameters.
       
   105         * @return Error code.
       
   106         */
       
   107         IMPORT_C TInt CspCPHSValueAddedServices(
       
   108             RMobilePhone::TCspValueAdded& aParams );
       
   109         
       
   110         /**
       
   111         * Get tele services flags from CSP.
       
   112         * @since 2.8.
       
   113         * @param aParams Tele services parameters.
       
   114         * @return Error code.
       
   115         */
       
   116         IMPORT_C TInt CspTeleServices(
       
   117             RMobilePhone::TCspTeleservices& aParams );
       
   118 
       
   119         /**
       
   120         * Get the changed CSP information after Refresh.
       
   121         * @since 2.8.
       
   122         * @param aChangedCsps The changed CSP fields, 
       
   123         *                     type RMobilePhone::TMobilePhoneCspFileV1Pckg.
       
   124         * @param aNewValues The new values of CSP fields, 
       
   125         *                   type RMobilePhone::TMobilePhoneCspFileV1Pckg.
       
   126         * @return Error code.  KErrNone if successful.
       
   127         */
       
   128         IMPORT_C TInt ChangedCspTable( 
       
   129             TDes8& aChangedCsps,
       
   130             TDes8& aNewValues );
       
   131 
       
   132     private:
       
   133 
       
   134         // Opens connections
       
   135         void DoOpenL();
       
   136 
       
   137         // Gets the values
       
   138         TInt DoGetValues( TInt& aValue, TSsGroups aGroup );
       
   139 
       
   140         // Reset the iOldCspFile.
       
   141         void DoResetOldCspFile();
       
   142 
       
   143         // Define and set the Publish and subscribe value.
       
   144         TInt DefineAndSetValue(
       
   145             TUid aCategory,
       
   146             TUint aKey,
       
   147             TInt aValue );
       
   148 
       
   149         // Prohibit copy constructor if not deriving from CBase.
       
   150         RCustomerServiceProfileCache(
       
   151             const RCustomerServiceProfileCache& );
       
   152         // Prohibit assigment operator if not deriving from CBase.
       
   153         RCustomerServiceProfileCache& operator= (
       
   154             const RCustomerServiceProfileCache& );
       
   155 
       
   156     private:
       
   157 
       
   158         // Member data structure.
       
   159         class TCspCacheData
       
   160             {
       
   161             public:
       
   162                 TCspCacheData();
       
   163                 
       
   164             // ETel connection.
       
   165             RTelServer iEtel;
       
   166             
       
   167             // Provides client access to mobile phone functionality 
       
   168             // provided by TSY.
       
   169             RMobilePhone iPhone;
       
   170             
       
   171             // Defines contents of the CSP (Customer Service Profile) 
       
   172             // on the SIM.
       
   173             RMobilePhone::TMobilePhoneCspFileV1 iCspFile;
       
   174             
       
   175             // Packaged contents of the CSP (Customer Service Profile) 
       
   176             // on the SIM.
       
   177             RMobilePhone::TMobilePhoneCspFileV1Pckg iCspFilePckg;
       
   178             
       
   179             // RProperty.
       
   180             RProperty       iProperty;
       
   181             };
       
   182 
       
   183         //Pointer to the above.
       
   184         TCspCacheData* iData;
       
   185 
       
   186         // Defines the old content of the CSP (Customer Service Profile) on 
       
   187         // the SIM before refresh.
       
   188         RMobilePhone::TMobilePhoneCspFileV1* iOldCspFile;
       
   189     };
       
   190 
       
   191 #endif      // RCUSTOMERSERVICEPROFILECACHE_H  
       
   192 
       
   193 // End of File