/*

* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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: 

*     This class provides connection/session related information.

*	  Both the requested and the stored AP's are here.

*

*

*/

#ifndef ConnMan_Active_Connector_H

#define ConnMan_Active_Connection_H

#include <e32base.h>

#include <nifman.h>

class TCommDbConnPref;

class TConnSnapPref;

const TInt KStageGoingBackwardsError = 10602;

//This class plays the role of a high level state machine in the connection creation

NONSHARABLE_CLASS(  CConnManActiveConnector ): public CActive

	{

public:	

	/**

	*Constructor

	*@param aAgent an RGenerericAgent

	*@param aPriority the priority of the active object

	*/

	CConnManActiveConnector( RConnection& aConnection, TInt aPriority = EPriorityStandard );

	/**

	*Destructor

	*/

	virtual ~CConnManActiveConnector();

	/**

	*This will activate the active object and start the connection creation process

	*It will complete on error or when the connection has been created

	*An important precondition: the agent that was passed must be opened before calling this function

	*and must not be closed before it completes

	*@param aSettings the overridesettings containing the connection characteristics

	*@param aStatus the status of the observer Active object

	*/

    void StartConnection( TCommDbConnPref* aSettings, TRequestStatus& aStatus );

    /**

	*This will activate the active object and start the connection creation process

	*It will complete on error or when the connection has been created

	*An important precondition: the agent that was passed must be opened before calling this function

	*and must not be closed before it completes

	*@param aSettings the overridesettings containing the connection characteristics

	*@param aStatus the status of the observer Active object

	*/

    void StartConnection( TConnSnapPref* aSettings, TRequestStatus& aStatus);

private://from CActive	

	/**

	*This method is implemented to enable proper cancellation of the active obect

	*/

	void DoCancel();			

	/**

	*RunL contains the decisions in different stages of the connection progress

	*/	

	void RunL();

private:

	TRequestStatus* iExternalRequestStatus;

    RConnection& iConnection;

	};

//This is a wrapper class on top of CConnManActiveConnector enabling asynch->synch conversion

NONSHARABLE_CLASS(  CActiveConnectorSyncWrapper ): public CActive

	{

public:

	/**

	*Symbian OS constructor 

	*@param aAgent a RGenerericAgent

	*@param aPriority the priority of the active object

	*/

    static CActiveConnectorSyncWrapper * NewL( RConnection& aConnection, TInt aPriority = EPriorityStandard );

	static CActiveConnectorSyncWrapper * NewL( TInt aPriority = EPriorityStandard );

	/**

	*Symbian OS constructor 

	*@param aAgent a RGenerericAgent

	*@param aPriority the priority of the active object

	*/

//	static CActiveConnectorSyncWrapper * NewLC( RGenericAgent& aAgent, TInt aPriority = EPriorityStandard );    CHANGED

    static CActiveConnectorSyncWrapper * NewLC( RConnection& aConnection, TInt aPriority = EPriorityStandard );

public:	

	/**

	*This will activate the active object and start the connection creation process

	*The it will return on error or when the connection has been created

	*An important precondition: the agent that was passed must be opened before calling this function

	*and must not be closed before it completes

	*@param aSettings the overridesettings containing the connection characteristics

	*@return the error code

	*/

    TInt Connect( TCommDbConnPref* aSettings );

    /**

	*This will activate the active object and start the connection creation process

	*The it will return on error or when the connection has been created

	*An important precondition: the agent that was passed must be opened before calling this function

	*and must not be closed before it completes

	*@param aSettings the overridesettings containing the connection characteristics

	*@return the error code

	*/    

    TInt ConnectSnap( TConnSnapPref* aSettings );

public:

    /**

	*Destructor

	*/

	virtual ~CActiveConnectorSyncWrapper();

private://from CActive

    /**

	*This function will release the active scheduler loop

	*/

	void RunL();

	/**

	*This function too releases the active scheduler loop

	*/

	void DoCancel();

protected:

	/**

	*Symbian OS second phase constructor

	*@param aAgent a RGenericAgent handle

	*/

	void ConstructL( RConnection& aConnection );

	/**

	*constructor

	*@param aPiority the priority of the active object

	*/

	CActiveConnectorSyncWrapper( TInt aPriority );

private:

	CActiveSchedulerWait iWait;

	CConnManActiveConnector* iActiveConnector;

	};

#endif// End of File