/*

* Copyright (c) 2004 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:  TAOStateExternalConnection class.

*

*/

#ifndef TAOSTATEEXTERNALCONNECTION_H

#define TAOSTATEEXTERNALCONNECTION_H

// INCLUDE FILES

#include "taostate.h"

// FORWARD DECLARATIONS

class MAOStateContext;

class MAOStatePool;

// CLASS DESCRIPTION

/**

*  External connection state class.

*

*  @lib PDPContextManager2.lib

*  @since S60 v3.1

*/

NONSHARABLE_CLASS( TAOStateExternalConnection ): public TAOState

	{

	public: // Constructors & destructors

    /**

     * Constructor.

     *

     * @since S60 v3.1

     * @param aStateContext Reference to MAOStateContext

     * @param aStatePool Reference to MAOStatePool

     */

    TAOStateExternalConnection(

            MAOStateContext& aStateContext,

            MAOStatePool& aStatePool );

    protected: // From base class TAOState

    /**

     * From TAOState.

     * Returns state name (ID).

     *

     * @since S60 v3.1

     */

    virtual TAOStateName StateName() const;

    /**

     * Handles connection deleted notification.

     *

     * @since S60 v3.1

     * @return New state or NULL if state is not needed to be changed.

     */

    virtual TAOState* HandleConnectionDeletedL();

    /**

     * Handles reset factory settings notification.

     * If this is overridden it must be remembered that

     * connection MUST be closed after this method has been

     * called. Otherwise factory resetting will fail.

     *

     * @since S60 v3.1

     * @return New state or NULL if state is not needed to be changed.

     */

    virtual TAOState* HandleResetFactorySettingsL( TBool aReset );

    // These all must be ignored in external connection settings state.

    // Though in real device these are impossible to receive.

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandlePDPContextActivatedL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandlePDPContextActivationFailedL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandlePDPContextDisconnectedL( TInt /*aReason*/ );

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

	virtual TAOState* HandleNetworkChangedL(

		    MAOConnectionManager::TNetworkType /*aNetworkType*/ );

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleSuccesfulRAUEventL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleRetryTimerTriggeredL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

	virtual TAOState* HandleConnectionTimerTriggeredL();

	    /**

     * From TAOState.

     * This is ignored in external connection state. Always returns NULL.

     *

     * @since S60 v3.2

     */

    virtual TAOState* HandleSettingsReceivedL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandlePDPContextTemporarilyBlockedL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleGeneralError();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleEnableAlwaysOnL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleSwitchFromDisconnectedL(

		    MAOConnectionManager::TFailureReason /*aReason*/ );

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleExternalConnectionCreatedL();

    /**

     * From TAOState.

     * This is ignored in external connection setting state. 

     * Always returns NULL.

     *

     * @since S60 v3.1

     */

    virtual TAOState* HandleUnconnectTimerExpiredL();

	};

#endif // TAOSTATEEXTERNALCONNECTION_H