1 /*

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

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:   SUPL Terminal Initiation internal class

    15 *

    16 */

    17 

    18 #ifndef __EPOS_SUPLTERMINALINTERNAL_H__

    19 #define __EPOS_SUPLTERMINALINTERNAL_H__

    20 

    21 

    22 #include <epos_suplterminal.h>

    23 

    24 #include "epos_suplgeocellinfo.h"

    25 

    26 

    27 // Forward declarations

    28 

    29 /**

    30  * This class is used to make request to convert area information to geo-coordinates. 

    31  */

    32 class RSuplTerminalInternal : public RSuplTerminalSubSession

    33 	{

    34 	

    35    

    36 public:

    37     /**

    38      * Constructor for RSuplTerminalInternal

    39      *

    40      */

    41 	IMPORT_C RSuplTerminalInternal(); 

    42 	

    43 	/**

    44      * This is an asynchronous request to SUPL Server to determine position 

    45      * information corresponding to given area information.

    46      * Client can have only one outstanding asynchronous request per sub-session.  

    47      * @param [OUT] aStatus to return result code 

    48      * @param[IN] aGeoCellInfo Cell information

    49      * @return aStatus will have 

    50      *         - KErrNone if request is completed sucessfully.  

    51      *         - KErrCancel if the request was successfully cancelled

    52      *         - KErrNotReady if SUPL server is not ready to determine position information, 

    53      *         			 client can retry after sometime.

    54      *         - KErrAlreadyExists if there is already an ongoing request on sub-session.

    55      *         - KErrServerTerminated if server got terminated due to some error

    56      *         - KErrNotSupported if function is called when Session is NOT Opened with SUPL_1_0 service

    57      *         - KErrGeneral for all other errors

    58      *

    59      */                    

    60     

    61     IMPORT_C void ConvertAreaInfoToCoordinates(

    62 					TRequestStatus& aStatus, 

    63 					TGeoCellInfo& aGeoCellInfo );

    64                     

    65     /**

    66      * Cancels an outstanding asynchronous conversion request issued via ConvertAreaInfoToCoordinates 

    67      *  Canceling requests is typically attempted when an client 

    68      * is closing down.

    69      *

    70      */

    71     IMPORT_C void CancelLocationConversion();

    72  

    73 private:

    74     //Cell Information

    75 	TGeoCellInfo iGeoCellInfo;

    76 	

    77 	//To check if conversion request has issued or not

    78 	TBool iConversionRequestIssued;

    79 	};

    80 

    81 #endif // __EPOS_SUPLTERMINALINTERNAL_H__