Constructor for RSuplTerminalSubSession

Cancels an outstanding asynchronous position determination, RunSession() , request. Canceling requests is typically attempted when an client is closing down.

Closes a sub-session with the SUPL Server. This must be called when the RSuplTerminalSubSession sub-session is no longer required. All the outstanding requests must be cancelled before closing sub-session.

Reserved for future expansion - derived classes should see documentation on how this is to be used.

If the position determined during RunSession() does not meet the quality criteria specified by the client, KSuplPositionQualityLoss is returned for GetPosition() . But client will still be able to get the position information if RunSession() is completed with KErrNone . Quality of position in RunSession() is optional and returning KSuplPositionQualityLoss error code is applicable only if client has mentioned QoP when invoking RunSession() .

This is an synchronous method for retrieving information on the server used during RSuplTerminalSubSession::RunSession() . This method should be called after RunSession is completed. It is client's responsibility to allocate enough memory to hold the server address and server address can have maximum size of 256 characters.

Retrieves list of SUPL server propertis configured. Client can use the retrieved SUPL server properties to specify the server address RunSession()

Listens for the event if any trigger is fired.

Client application must call StartSuplTriggerSession() before calling NotifyTriggerFired() .

Client applications can use this method to get notified when a periodic trigger is fired. The firing information is returned to the client application. If more that one trigger is fired, Supl Trigger Server will complete the request and the first fired trigger is returned. Client application shall call this method again to get next trigger firing.

A client application will get Trigger firing response that are created by itself.

This method requires Location capability.

Since this is an asynchronous call, client has to wait for status on aStatus parameter to know the result of position determination.

Client can cancel this request using RSuplTerminalSubSession::StopSuplTriggerSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the StopSuplTriggerSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

Opens a sub-session to the SUPL Server. Client can request for position determination, can request for procedure to get assistance data and retrieve position information through sub-session. Panic ESuplServerHandleNotClosed occurs if sub-session is already opened

This is an asynchronous request to SUPL Server to determine position information or to determine additional positioning information such as assistance data. Client can have only one outstanding asynchronous request per sub-session.

Parameter aQop is of type TSuplTerminalQop and can be used by the Terminal Initiation API client to specify the desired quality of position. Client can specify horizontal accuracy, vertical accuracy, maximum location age and response time using this parameter.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL Server. By default, the value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

Since this is an asynchronous call, the client has to wait for status on aStatus parameter to know the result of position determination.

Client can cancel this request using RSuplTerminalSubSession::CancelRunSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the CancelRunSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

This is an synchronous request to SUPL server to determine position information or to determine additional positioning information.

Parameter aQop is of type TSuplTerminalQop and can be used by the Terminal Initiation API client to specify the desired quality of position. Client can specify horizontal accuracy, vertical accuracy, maximum location age and response time using this parameter.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL Server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

This is an asynchronous request to SUPL Server to determine position information or to determine additional positioning information such as assistance data. Client can have only one outstanding asynchronous request per sub-session.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL Server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

Since this is an asynchronous call, client has to wait for status on aStatus parameter to know the result of position determination.

Client can cancel this request using RSuplTerminalSubSession::CancelRunSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the CancelRunSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

This is an synchronous request to SUPL Server to determine position information or to determine additional positioning information.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

This is an asynchronous request to SUPL Server to determine position information or to determine additional positioning information such as assistance data. Client can have only one outstanding asynchronous request per sub-session.

Parameter aQop is of type TSuplTerminalQop and can be used by the Terminal Initiation API client to specify the desired quality of position. Client can specify horizontal accuracy, vertical accuracy, maximum location age and response time using this parameter.

Parameter aHslpAddress is used to specify SUPL server to be used. The list of configured SUPL server addresses can be obtained using GetSlpList() . The SUPL server address is one of the parameter in the the server properties obtained.

Parameter aFallBack can be used to specify if the fallback to other configured server is allowed if SUPL session with the server address specified fails.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL Server. By default, the value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

Since this is an asynchronous call, the client has to wait for status on aStatus parameter to know the result of position determination.

Client can cancel this request using RSuplTerminalSubSession::CancelRunSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the CancelRunSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

This is an synchronous request to SUPL server to determine position information or to determine additional positioning information.

Parameter aQop is of type TSuplTerminalQop and can be used by the Terminal Initiation API client to specify the desired quality of position. Client can specify horizontal accuracy, vertical accuracy, maximum location age and response time using this parameter.

Parameter aHslpAddress is used to specify SUPL server to be used. The list of configured SUPL server addresses can be obtained using GetSlpList() . The SUPL server address is one of the parameter in the the server properties obtained.

Parameter aFallBack can be used to specify if the fallback to other configured server is allowed if SUPL session with the server address specified fails.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL Server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

This is an asynchronous request to SUPL Server to determine position information or to determine additional positioning information such as assistance data. Client can have only one outstanding asynchronous request per sub-session.

Parameter aHslpAddress is used to specify SUPL server to be used. The list of configured SUPL server addresses can be obtained using GetSlpList() . The SUPL server address is one of the parameter in the the server properties obtained.

Parameter aFallBack can be used to specify if the fallback to other configured server is allowed if SUPL session with the server address specified fails.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL Server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

Since this is an asynchronous call, client has to wait for status on aStatus parameter to know the result of position determination.

Client can cancel this request using RSuplTerminalSubSession::CancelRunSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the CancelRunSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

This is an synchronous request to SUPL Server to determine position information or to determine additional positioning information.

Parameter aHslpAddress is used to specify SUPL server to be used. The list of configured SUPL server addresses can be obtained using GetSlpList() . The SUPL server address is one of the parameter in the the server properties obtained.

Parameter aFallBack can be used to specify if the fallback to other configured server is allowed if SUPL session with the server address specified fails.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Parameter aFirstReq can be used by the Terminal Initiation API client to indicate whether the request is the first request in the subsession or not. By default, this is set to ETrue to indicate that the request is the first one. For second request onwards this parameter should be set to EFalse to indicate that the request is not the first one.

This is an asynchronous request to SUPL Server to start periodic triggering to determine position information or to determine additional positioning information such as assistance data at given interval of time subsequently. Client can have only one outstanding asynchronous request per sub-session.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

FallBack mechanism is enabled as default to allow other servers if SUPL session with the server address specified fails.

Since this is an asynchronous call, client has to wait for status on aStatus parameter to know the result of starting the triggering session.

Client can cancel this request using RSuplTerminalSubSession::StopSuplTriggerSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the StopSuplTriggerSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

This is an asynchronous request to SUPL Server to start periodic triggering to determine position information or to determine additional positioning information such as assistance data at given interval of time subsequently. Client can have only one outstanding asynchronous request per sub-session.

Parameter aHslpAddress is used to specify SUPL server to be used. The list of configured SUPL server addresses can be obtained using GetSlpList() . The SUPL server address is one of the parameter in the the server properties obtained.

Parameter aFallBack can be used to specify if the fallback to other configured server is allowed if SUPL session with the server address specified fails.

Client can use more than one option from the above table using logical 'OR' operator.

Parameter aRequestId can be used by the Terminal Initiation API client to deliver a request identifier to the tunneled positioning protocol handler if needed. This is used by the client which is requesting for additional position information such as assistance data for A-GPS. Tunneled protocol can use this value for example to match different assistance data requests and response received from SUPL server. By default, value of this parameter is set to zero. It is client's responsibility to generate and keep track of this request identifier, if used.

Since this is an asynchronous call, client has to wait for status on aStatus parameter to know the result of starting the triggering session.

Client can cancel this request using RSuplTerminalSubSession::StopSuplTriggerSession . Before a client closes a sub-session, it must ensure that all outstanding requests have been cancelled. In particular, after the client has invoked the StopSuplTriggerSession() method, it must wait until SUPL Server has reported that the request has indeed been cancelled. Panic ESuplDuplicateRequest occurs if there is already an outstanding request for the sub session.

Stops an outstanding asynchronous request used for Triggering. This method is used to cancel both StartSuplTriggerSession() and NotifyTriggerFired() which ever is outstanding at that time.

Stopping requests is typically attempted when an client is closing down.

For differentiating request between Supl Service Versions

A pointer to a container that holds pointer descriptors, needed to point to the clients request data during asynchronous requests

Unused variable for future expansion.