satengine/SatServer/Engine/inc/CSatApnHandler.h
changeset 0 ff3b6d0fd310
child 8 ba42c4bd84dd
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/satengine/SatServer/Engine/inc/CSatApnHandler.h	Tue Feb 02 01:11:09 2010 +0200
@@ -0,0 +1,128 @@
+/*
+* Copyright (c) 2002-2008 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:  Handles APN operations
+*
+*/
+
+
+
+#ifndef CSATAPNHANDLER_H
+#define CSATAPNHANDLER_H
+
+//  INCLUDES
+#include <e32base.h>
+#include "MSatApnHandler.h"
+
+class MSatUtils;
+
+/**
+*  Handles the Access point operations with CMManager. Searches, inserts and
+*  deletes APNs, if neccessary
+*
+*  @lib SatEngine
+*  @since S60 3.0
+*/
+class CSatApnHandler : public CBase,
+                       public MSatApnHandler
+    {
+    public:  // Constructors and destructor
+
+        /**
+        * Two-phased constructor.
+        * @param aUtils Reference to SAT Utils
+        */
+        static CSatApnHandler* NewL( MSatUtils& aUtils );
+
+        /**
+        * Destructor.
+        */
+        virtual ~CSatApnHandler();
+
+    public: // Functions from MSatApnHandler
+
+        /**
+        * Locates APN from CMManager, creates new APN if not found, and
+        * returns IAP id and Network ID in referenced parameters
+        * @param aName Accesspoint to locate / create
+        * @param aUserLogin, User name in case new APN is needed
+        * @param aUserPwd, Password in case, new APN is needed
+        * @param aIapId, after completion, holds the IAP id of the APN
+        * @param aNwId, after completion, holds the Network id of the APN
+        * @param aApnCreated indicates is new APN created
+        * @param aPdpType, indicates whether the address type is IPv4  or IPv6
+        * @param aLocalAddress, represents the Local Address provided by NAA
+        */
+        void GetApnInfoL(
+            const RSat::TAccessName& aName,
+            const RSat::TTextString& aUserLogin,
+            const RSat::TTextString& aUserPwd,
+            TUint32& aIapId,
+            TUint32& aNwId,
+            TBool& aApnCreated,
+            const RPacketContext::TProtocolType& aPdpType,
+            const TDesC8& aLocalAddress );
+
+        /**
+        * Deletes the connection method with given APN ID. Note that aApnId is 
+        * the same id that GetApnInfoL returns in aNwId.
+        * @param aApnId APN to delete
+        */
+        void DeleteApnL( TUint32 aApnId );
+
+    private:
+
+        /**
+        * C++ default constructor.
+        * @param aUtils Reference to SAT Utils
+        */
+        CSatApnHandler( MSatUtils& aUtils );
+
+        /**
+        * create a new connection method  in case, access point does not exist
+        * @param aReqApn Formatted required access point name.
+        * @param aUserLogin User name
+        * @param aUserPwd Password
+        * @param aIapId, after completion, holds the IAP id of the new APN
+        * @param aNwId, after completion, holds the Network id of the new APN
+        * @param aPdpType, indicates whether the address type is IPv4  or IPv6
+        * @param aLocalAddress, represents the Local Address provided by NAA
+        */
+        void InsertRecordL(
+            const TDesC& aReqApn,
+            const RSat::TTextString& aUserLogin,
+            const RSat::TTextString& aUserPwd,
+            TUint32& aIapId,
+            TUint32& aNwId,
+            const RPacketContext::TProtocolType aPdpType,
+            const TDesC8& aLocalAddress );
+
+        /**
+        * Formats the APN from SIM into correct format.
+        * @param aReqApn Accesspoint to format
+        * @return Returns formatted APN in an HBufC
+        *         Invoker is responsible to release
+        *         the memory! 
+        */
+        HBufC* FormatAPN( const RSat::TAccessName& aReqApn ) const;
+
+    private:  // Data
+
+        // Reference to command container
+        MSatUtils& iUtils;
+
+    };
+
+#endif      // CSATAPNHANDLER_H
+
+// End of File