/*

* Copyright (c) 2006 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:  	This class inherits the common functionalities for requests to the 

*				Location Monitor from EPos_CPosLocMonitorReqHandlerBase.h and also

*				implements the functions specific to Last Known Position Area request.

*

*/

#ifndef CPOSLASTKNOWNPOSAREAHANDLER_H_

#define CPOSLASTKNOWNPOSAREAHANDLER_H_

//--------------------------------------------------------------------------------------

// INCLUDES

#include <e32base.h>

#include <e32std.h>

#include <e32def.h>

#include <e32cmn.h>

#include "LbsErrors.h" 

#include "EPos_Global.h" 		// For DEBUG_TRACE

#include "EPos_ServerPanic.h" 	// For EPosServerPanicPositionerNotInitialized

#include "EPos_CPosLocMonitorReqHandlerBase.h"

#include "rlbslocmonitorsession.h"

#include "rlbslocmonitorareapositioner.h"

//--------------------------------------------------------------------------------------

// FORWARD DECLARATIONS

class CPosCallbackTimer;	// Used for timeout

//--------------------------------------------------------------------------------------

// CONSTANT DEFINITIONS

//  Index of the pointer to a container that holds pointer descriptors, needed to point

//	to the clients request data during asynchronous requests */

const TInt KParamLKPAreaReqPos   = 0;

const TInt KParamLKPAreaReqArea  = 1;

// The timeout value for get last known position area request is 10seconds

const TTimeIntervalMicroSeconds KLastKnownPosAreaTimeOut(10000000);

//--------------------------------------------------------------------------------------

// CLASS DECLARATION

/**

 The active object that handles requests for last known position with area info from 

 clients. Owns subsession with the location monitor and uses the sub-session handle to 

 forward the above requests to the location monitor. Inherits the basic functionalities from 

 CPosLocMonitorReqHandlerBase.

 */

class CPosLastKnownPosAreaHandler : public CPosLocMonitorReqHandlerBase

	{

public: 

	// Two-phased Constructors 

	static CPosLastKnownPosAreaHandler* NewL(); 

    // Destructors

	~CPosLastKnownPosAreaHandler();  

	// Functions to request last known position with area info from the Location Monitor

    void GetLastKnownPosAreaL(RLbsLocMonitorSession& aLocMonSession, const RMessage2& aMessage);

    void CancelGetLastKnownPosAreaL(const RMessage2& aMessage);

    void NotifyOnEmptyLastKnownPosStoreReq();

private:

	// C++ Default constructor

	CPosLastKnownPosAreaHandler(); 

	void ConstructL(); 	

	static TInt HandleTimeOut(TAny* aRequestHandler);

protected:  

	// From CActive

    void RunL();

    TInt RunError(TInt aError);

    void DoCancel();

private:

	RMessage2 		iMessage;

	// Subsession with the location monitor

	RLbsLocMonitorAreaPositioner 	iLocMonAreaPositioner; 

	TPositionInfo   			iPositionInfo;

	TPositionAreaExtendedInfo 	iPositionAreaInfo;

	TPosAreaReqParams 			iParameters;

	CPosCallbackTimer* 			iTimeoutTimer; // The timeout value is hardcoded in the constant KLastKnownPosAreaTimeOut

	};

#endif /*CPOSLASTKNOWNPOSAREAHANDLER_H_*/