iapconnectengine.h

symbian中如何取得内部联网方式

/*
* ============================================================================
*  Name     : CIAPConnectEngine from IAPConnectEngine.h
*  Part of  : Internet Access Points Example v2.0
*  Description:
*     Declares Engine class for the application.
*  Created  : 01.09.2006 by Forum Nokia
*  Version  : 2.0
*  Copyright: Forum Nokia
* ============================================================================
*/

#ifndef IAPCONNECT_ENGINE_H
#define IAPCONNECT_ENGINE_H

// INCLUDES
#include "IAPConnectStateObserver.h"
#include "IAPConnectDemoEngineObserver.h"
#include "IAPConnectDemoEngine.h"

#include <e32base.h>
#include <CommDbConnPref.h>
#include <es_sock.h>

#include <cdbcols.h>
#include <commdb.h>
#include <cdbtemp.h>

// FORWARD DECLARATIONS
class CIAPConnectWaitDialog;
class CIAPConnectProgressNotifier;
class CTextResolver;

// CONSTANTS
const TUint32 KUndefinedIAPid = 0x00;

// CLASS DECLARATION

/**
* CIAPConnectEngine  Controls the internet connection initiation and shutdown
*/
class CIAPConnectEngine : public CActive
    {
public:
    
    /*
     * NewL()
     *  
     * Create CIAPConnectEngine object
     *
     * Params:
     * MIAPConnectStateObserver* aObserver State observer interface
     * MIAPConnectDemoEngineObserver* aDemoEngineObserver Demo 
     *      engine observer
     */
    static CIAPConnectEngine* NewL(
        MIAPConnectStateObserver* aObserver,
        MIAPConnectDemoEngineObserver* aDemoEngineObserver);

    /*
     * NewL()
     *  
     * Create CIAPConnectEngine object and store pointer to the cleanup stack
     *
     * Params:
     * MIAPConnectStateObserver* aObserver State observer interface
     * MIAPConnectDemoEngineObserver* aDemoEngineObserver Demo 
     *      engine observer
     */
    static CIAPConnectEngine* NewLC(
        MIAPConnectStateObserver* aObserver,
        MIAPConnectDemoEngineObserver* aDemoEngineObserver);

    /*
     * ~CIAPConnectEngine()
     *  
     * Destructor
     *
     */
    ~CIAPConnectEngine();
  
    /*
     * ConnectL()
     *  
     * Creates a connection to IAP
     *
     */
    void ConnectL();

    
    /*
     * ReleaseL()
     *  
     * Release the connection
     *
     */
    void ReleaseL();
        
    /*
     * TerminateConnectionL()
     *  
     * Terminate an active connection
     *
     */
    void TerminateConnectionL();

    /*
     * SetConnectionPreferences()
     *  
     * Sets connection preferences
     *
     * Params:
     * TUint aBearer    Bearer type
     * TBool aDialog    Show dialog? 
     * TUint32 aIapId   IAP to be connected, default KUndefinedIAPid
     *
     */
    void SetConnectionPreferences(TUint aBearer, TBool aDialog, 
        TUint32 aIapId=KUndefinedIAPid);

    /*
     * SelectAccessPointL()
     *  
     * Launch an access point selection list
     *
     * Params:
     * TUint32& aSelectedIap    IAP id of the selected access point
     *
     */
    void SelectAccessPointL(TUint32& aSelectedIap);

    /*
     * IsConnected()
     *  
     * Check if an active connection to specied IAP
     *
     * Params:
     * TUint32& aIap    IAP id
     *
     * Returns:
     * TBool    yes/no
     */
    TBool IsConnectedL(TUint32& aIap);
    
    /*
     * HBufC* GetConnectionInfoL()
     *  
     * Get info about active connections
     *
     * Params: N/A
     *
     * Return: A heap descriptor containing the information
     */
    HBufC* GetConnectionInfoL();
    
    /*
     * CIAPConnectDemoEngine* DemoEngine()
     *  
     * Get a pointer to the demo engine
     *
     * Params: N/A
     *
     * Return: A pointer to the demo engine
     */
    CIAPConnectDemoEngine* DemoEngine();
    
    /*
     * GetState()
     *  
     * Get connection state
     *
     * Returns:
     * TInt     Connection state, see TIAPConnectEngineStates
     *
     */
    TInt GetState() const;

    /*
     * GetConnectionIndex()
     *  
     * Get the index of the connection we are currently using
     *
     * Returns:
     * TInt     KErrNone if the index is found, otherwise an error code
     *
     */
    TInt GetConnectionIndex(TUint& aConnIndex);

	void CreateNewIapL(const TDesC& aIapName);

protected: // from CActive

    /*
     * RunL()
     *  
     * Handle request completion events
     *
     */
    void RunL();

    /*
     * DoCancel()
     *  
     * Cancel any outstanding requests
     *
     */
    void DoCancel();
    
private:

    /*
     * CIAPConnectEngine()
     *  
     * Constructor
     *
     * Params:
     * MIAPConnectStateObserver* aObserver State observer
     */
    CIAPConnectEngine(MIAPConnectStateObserver* aObserver);

    /*
     * ConstructL(MIAPConnectDemoEngineObserver* aDemoEngineObserver)
     *  
     * Second phase constructor
     *
     */
    void ConstructL(MIAPConnectDemoEngineObserver* aDemoEngineObserver);

    /*
     * PrintNoteL()
     *  
     * Show information note
     *
     * Params:
     * const TDesC& aNoteText   Text to be shown
     *
     */
    void PrintNoteL(const TDesC& aNoteText);
    
    /*
     * PrintErrorL()
     *  
     * Print error note
     *
     * Params:
     * const TDesC& aErrorText  Error text to be shown
     * TInt aErrorCode          Error code
     *
     */
    void PrintErrorL(const TDesC& aErrorText, TInt aErrorCode);
    
    /*
     * ShowQueryDialogL()
     *  
     * Show termination query dialog and returns true/false
     *
     * Returns:
     * TInt Response from the user
     */
    TInt ShowQueryDialogL();

    /*
     * CreateNewOgGprsL()
     *  
     * Params:
     *  CCommsDatabase& aCommsDb 
     *  TDesC& aCommsdb_name
     *  TUint32& aOgGprsId
     */
	void CreateNewOgGprsL(CCommsDatabase& aCommsDb, const TDesC& aCommsdb_name, TUint32& aOgGprsId);

    /*
     * CreateNewAccessPointL()
     *  
     * Params:
     *   CCommsDatabase& aCommsDb 
     *   TDesC& aCommsdb_name
     *   TUint32& aApId
     */

	void CreateNewAccessPointL(CCommsDatabase& aCommsDb, const TDesC& aCommsdb_name, TUint32& aApId);

private:

    TCommDbConnPref iPref;

    // Owns
    RConnection iConnect;
    RSocketServ iSocketServ;
    CTextResolver* iTextResolver;
    CIAPConnectProgressNotifier* iProgressNotifier;

    // For the demo
    CIAPConnectDemoEngine* iDemoEngine;
    TBool iRunningDemo;

    // Owned by CIAPAppUi
    MIAPConnectStateObserver* iObserver;    
    };


#endif // IAPCONNECT_ENGINE_H