Collapse all Symbian^3 Application Developer Library

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

CLbsSuplPush
- CBase

Public Member Functions
	~CLbsSuplPush ()
IMPORT_C CLbsSuplPush *	NewL ( TLbsSuplPushChannel , MLbsSuplPushObserver &)
IMPORT_C TInt	SuplInit ( TLbsSuplPushRequestId &, const TDesC8 &, TInt )

Private Member Functions
	CLbsSuplPush ()
	CLbsSuplPush (const CLbsSuplPush &)
void	ConstructL ( TLbsSuplPushChannel , MLbsSuplPushObserver &)
CLbsSuplPush &	operator= (const CLbsSuplPush &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Private Attributes
CLbsSuplPushImpl *	iImpl

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