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 the License "Symbian Foundation License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.symbianfoundation.org/legal/sfl-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 

    19 #ifndef __EPOS_SUPLTERMINALINTERNAL_H__

    20 #define __EPOS_SUPLTERMINALINTERNAL_H__

    21 

    22 

    23 #include <epos_suplterminal.h>

    24 

    25 #include "epos_suplgeocellinfo.h"

    26 

    27 

    28 // Forward declarations

    29 

    30 /**

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

    32  */

    33 class RSuplTerminalInternal : public RSuplTerminalSubSession

    34 	{

    35 	

    36    

    37 public:

    38     /**

    39      * Constructor for RSuplTerminalInternal

    40      *

    41      */

    42 	IMPORT_C RSuplTerminalInternal(); 

    43 	

    44 	/**

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

    46      * information corresponding to given area information.

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

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

    49      * @param[IN] aGeoCellInfo Cell information

    50      * @return aStatus will have 

    51      *         - KErrNone if request is completed sucessfully.  

    52      *         - KErrCancel if the request was successfully cancelled

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

    54      *         			 client can retry after sometime.

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

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

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

    58      *         - KErrGeneral for all other errors

    59      *

    60      */                    

    61     

    62     IMPORT_C void ConvertAreaInfoToCoordinates(

    63 					TRequestStatus& aStatus, 

    64 					TGeoCellInfo& aGeoCellInfo );

    65                     

    66     /**

    67      * Cancels an outstanding asynchronous conversion request issued via ConvertAreaInfoToCoordinates 

    68      *  Canceling requests is typically attempted when an client 

    69      * is closing down.

    70      *

    71      */

    72     IMPORT_C void CancelLocationConversion();

    73  

    74 private:

    75     //Cell Information

    76 	TGeoCellInfo iGeoCellInfo;

    77 	

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

    79 	TBool iConversionRequestIssued;

    80 	};

    81 

    82 #endif // __EPOS_SUPLTERMINALINTERNAL_H__