satengine/SatServer/inc/TSatExtErrorUtils.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:  Maps extended error values to correct values.
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 
       
    20 #ifndef TSATEXTERRORUTILS_H
       
    21 #define TSATEXTERRORUTILS_H
       
    22 
       
    23 #include <e32std.h>
       
    24 // CLASS DECLARATION
       
    25 
       
    26 /**
       
    27 *  Extended GSM error utility class. Used to map extended error codes into
       
    28 *  correct Network errors. These values are used in SetUpCall, SendSs,
       
    29 *  SendUssd and SendSm TerminalResponses, when network returns error.
       
    30 *
       
    31 *  @lib SatEngine.lib
       
    32 *  @since 3.0
       
    33 */
       
    34 class TSatExtErrorUtils
       
    35     {
       
    36     
       
    37     public: // New functions
       
    38 
       
    39         /**
       
    40         * Maps extended error value to correct value.
       
    41         * @param aExtError Extended GSM error defined in exterror.h
       
    42         * @param aModifyMappedValue, should 8th bit changed into 1 or not. 
       
    43         *        default is ETrue
       
    44         * @return Hex number indicating the correct value
       
    45         */
       
    46         IMPORT_C static TUint8 MapError( 
       
    47             TInt  aExtError, 
       
    48             TBool aModifyMappedValue = ETrue );
       
    49 
       
    50         /**
       
    51         * Check is given value GSM extended error
       
    52         * @param aExtError Value to be checked
       
    53         * @return TBool indicating is the value extended GSM error
       
    54         */
       
    55         IMPORT_C static TBool IsExtendedError( TInt aExtError );
       
    56 
       
    57         /**
       
    58         * Check should given extended error to be handled as network error
       
    59         * @param aExtError Value to be checked
       
    60         * @return TBool indicating is the value network error
       
    61         */
       
    62         IMPORT_C static TBool IsNetworkError( TInt aExtError );
       
    63         
       
    64     private:
       
    65         
       
    66         /**
       
    67         * Checks specific cases of error codes and changes the code, 
       
    68         * if neccessary.
       
    69         * @param aExtErrorCode code to be checked
       
    70         * @param aNwError, this is where the new nw value is set
       
    71         */
       
    72         static void CheckSpecificCases( TInt aExtError, TUint8& aNwError );
       
    73 
       
    74     };
       
    75 
       
    76 #endif      // TSATEXTERRORUTILS_H
       
    77 
       
    78 // End of File