CLbsSuplPush Class Reference

class CLbsSuplPush : public CBase

The CLbsSuplPush class provides an interface to send SUPL INIT Push messages into the LBS sub-system. Normally SUPL INIT messages arrive through SMS or WAP push and, if accepted, result in the opening of a a TCP/IP connection to the SLP (SUPL Server).

Although it is possible for multiple threads to open a channel of the same type (e.g. SMS or WAP), only one thread can actively use the channel at any time. A system requiring concurrent access to a channel must provide its own access control mechanism.

Unless documented explicitly, no assumptions should be made about the order and/or content of notifications generated by the LBS sub-system through this or other interfaces.

MLbsSuplPushObserver

Inherits from

Constructor & Destructor Documentation

CLbsSuplPush()

CLbsSuplPush ( ) [private]

Default constructor.

CLbsSuplPush(const CLbsSuplPush &)

CLbsSuplPush ( const CLbsSuplPush & ) [private]

Parameters

const CLbsSuplPush &

~CLbsSuplPush()

~CLbsSuplPush ( ) [virtual]

Closes the interface and disposes all open or used resources.

Member Functions Documentation

ConstructL(TLbsSuplPushChannel, MLbsSuplPushObserver &)

void ConstructL ( TLbsSuplPushChannel aChannel,
MLbsSuplPushObserver & aObserver
) [private]

2nd phase constructor. Creates and assigns all the required internal resources.

Parameters

TLbsSuplPushChannel aChannel The id of the channel to be opened.
MLbsSuplPushObserver & aObserver A reference to an observer waiting for request completion call-backs.

NewL(TLbsSuplPushChannel, MLbsSuplPushObserver &)

IMPORT_C CLbsSuplPush * NewL ( TLbsSuplPushChannel aChannel,
MLbsSuplPushObserver & aObserver
) [static]

Opens a new SUPL Push channel to the LBS sub-system.

capability
NetworkServices
capability
ReadDeviceData

Parameters

TLbsSuplPushChannel aChannel [In] The id of the channel to be opened.
MLbsSuplPushObserver & aObserver [In] A reference to an observer waiting for request completion call-backs.

SuplInit(TLbsSuplPushRequestId &, const TDesC8 &, TInt)

IMPORT_C TInt SuplInit ( TLbsSuplPushRequestId & aReqId,
const TDesC8 & aMsg,
TInt aReserved
)

Sends a SUPL INIT message to the LBS sub-system. If the channel is busy sending a previous message the new one will be queued. The request completion code is received through a call-back.

Please note that only one thread can actively use a channel at any time. Simultaneous use of a channel by multiple threads may cause some of the requests to time out.

A system requiring concurrent access to a channel must provide its own access control mechanism.

MLbsSuplPushObserver::OnSuplInitComplete()
capability
NetworkServices
capability
ReadDeviceData

Parameters

TLbsSuplPushRequestId & aReqId [Out] Channel unique request Id.
const TDesC8 & aMsg [In] A buffer containing a SUPL INIT message.
TInt aReserved [In] Reserved for future use.

operator=(const CLbsSuplPush &)

CLbsSuplPush & operator= ( const CLbsSuplPush & ) [private]

Parameters

const CLbsSuplPush &

Member Data Documentation

CLbsSuplPushImpl * iImpl

CLbsSuplPushImpl * iImpl [private]

CLbsSuplPushImpl* Impl is the internal handle to the Implementation