secsrv_plat/security_code_ui_api/inc/SecUiManualSecuritySettings.h
changeset 0 164170e6151a
equal deleted inserted replaced
-1:000000000000 0:164170e6151a
       
     1 /*
       
     2 * Copyright (c) 2002 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: 
       
    15 *    Provides api for changing security settings via PhoneApp
       
    16 *
       
    17 *
       
    18 */
       
    19 
       
    20 
       
    21 #ifndef     __SECUIMANUALSECURITYSETTINGS_H
       
    22 #define     __SECUIMANUALSECURITYSETTINGS_H
       
    23 
       
    24 //  INCLUDES
       
    25 // #include <etelagsm.h>
       
    26 #include <etelmm.h>
       
    27 #include <aknnotedialog.h>
       
    28 #include <rmmcustomapi.h>
       
    29 
       
    30 class CWait;
       
    31 
       
    32 class CManualSecuritySettings : public CBase
       
    33 	{
       
    34     public:
       
    35 		/**
       
    36         * Creates instance of the CManualSecuritySettings class.
       
    37         *
       
    38 		* @return Returns the instance just created.
       
    39         */
       
    40 		IMPORT_C static CManualSecuritySettings* NewL();
       
    41 		/**
       
    42         * Destructor.
       
    43         */
       
    44 		IMPORT_C ~CManualSecuritySettings();		
       
    45 	public:
       
    46 		/**
       
    47 		* Enumerates pins.
       
    48 		*/
       
    49 		enum TPin
       
    50 			{
       
    51 			EPin1,
       
    52 			EPin2
       
    53 			};
       
    54 		
       
    55 		/**
       
    56 		* Changes pin.
       
    57 		*
       
    58 		* Note that contents of aOld, aNew & aVerifyNew haven't been checked. If they could not been parsed,
       
    59 		* they are empty strings (KNullDesC).
       
    60 		*
       
    61 		* @param aPin pin in question.
       
    62 		* @param aOld old pin.
       
    63 		* @param aNew new pin.
       
    64 		* @param aVerifyNew new pin, verification.
       
    65 		* @return ETrue iff pin was changed successfully.
       
    66 		*/
       
    67 		IMPORT_C TBool ChangePinL(TPin aPin,const TDesC& aOld,const TDesC& aNew,const TDesC& aVerifyNew );	
       
    68 
       
    69 		/**
       
    70 		* Cancels change pin operation.
       
    71 		*
       
    72 		* If there is no ongoing change pin operation, then
       
    73 		* this method does nothing.
       
    74 		*/
       
    75 		IMPORT_C void CancelChangePin();
       
    76 
       
    77 		/**
       
    78 		* Unblocks pin.
       
    79 		*
       
    80 		* Note that contents of aPuk, aNew & aVerifyNew haven't been checked. If they could not been parsed,
       
    81 		* they are empty strings (KNullDesC).
       
    82 		*
       
    83 		* @param aPin pin in question.
       
    84 		* @param aPuk puk code for the pin.
       
    85 		* @param aNew new pin.
       
    86 		* @param aVerifyNew new pin, verificatio.
       
    87 		* @return ETrue iff pin was unblocked successfully.
       
    88 		*/
       
    89 		IMPORT_C TBool UnblockPinL(TPin aPin,const TDesC& aPuk,const TDesC& aNew,const TDesC& aVerifyNew );
       
    90 
       
    91 		/**
       
    92 		* Cancels unblock pin operation.
       
    93 		*
       
    94 		* If there is no ongoing unblock pin operation, then
       
    95 		* this method does nothing.
       
    96 		*/
       
    97 		IMPORT_C void CancelUnblockPin();
       
    98 			
       
    99 		/**
       
   100 		* Locks sim.
       
   101 		*
       
   102 		* Note that contents of aLockCode & aType haven't been checked. If they could not been parsed, 
       
   103 		* they are empty strings (KNullDesC).
       
   104 		*
       
   105 		* @param aLockCode lock closing password.
       
   106 		* @param aType type of lock.
       
   107 		* @return ETrue iff SIM was locked successfully.
       
   108 		*/
       
   109 		IMPORT_C TBool LockSimL(const TDesC& aLockCode,const TDesC& aType );
       
   110 
       
   111 		/**
       
   112 		* Cancels lock sim operation.
       
   113 		*
       
   114 		* If there is no ongoing lock sim operation, then
       
   115 		* this method does nothing.
       
   116 		*/
       
   117 		IMPORT_C void CancelLockSim();
       
   118 
       
   119 		/**
       
   120 		* Unlocks sim.
       
   121 		*
       
   122 		* Note that contents of aUnlockCode & aType haven't been checked. If they could not been parsed, 
       
   123 		* they are empty strings (KNullDesC).
       
   124 		*
       
   125 		* @param aUnlockCode lock opening password.
       
   126 		* @param aType type of lock.
       
   127 		* @return ETrue if SIM was unlocked successfully.
       
   128 		*/
       
   129 		IMPORT_C TBool UnlockSimL(const TDesC& aUnlockCode,const TDesC& aType );
       
   130 
       
   131 		/**
       
   132 		* Cancels unlock sim operation.
       
   133 		*
       
   134 		* If there is no ongoing unlock sim operation, then
       
   135 		* this method does nothing.
       
   136 		*/
       
   137 		IMPORT_C void CancelUnlockSim();
       
   138 	public:
       
   139 		/**
       
   140 		* Shows operation results in note
       
   141 		*
       
   142 		* @param aTone CAknNoteDialog::TTone (tone which is played)
       
   143 		* @param aResourceID TInt (notes resource id)
       
   144 		*/
       
   145 		void ShowResultNoteL(CAknNoteDialog::TTone aTone, TInt aResourceID);
       
   146 	private: // constructors
       
   147 		/**
       
   148         * C++ default constructor.
       
   149         */
       
   150         CManualSecuritySettings();
       
   151 		 /**
       
   152 		* Symbian OS constructor.
       
   153         */
       
   154         void ConstructL();	
       
   155 	private:  // data
       
   156 		/*****************************************************
       
   157 		*	Series 60 Customer / ETel
       
   158 		*	Series 60  ETel API
       
   159 		*****************************************************/
       
   160 		RMmCustomAPI	iCustomPhone;
       
   161 		RTelServer      iServer;
       
   162 		// RAdvGsmPhone    iPhone;
       
   163 		RMobilePhone	iPhone;
       
   164 		CAknNoteDialog* iNote;
       
   165 		TRequestStatus	iDummyStatus;
       
   166 		CWait*			iWait;
       
   167 
       
   168 	};
       
   169 #endif      
       
   170             
       
   171 // End of file