Collapse all Symbian^3 Product Developer Library

MLbsPrivacyObserver Class Reference

class MLbsPrivacyObserver

The mixin class that defines the interface for the LBS privacy controller observer.

The callbacks defined in this class are called by the LBS system when needed, e.g. when a network location request is received, when the reference position is received, when the final position is calculated and when the request has completed.

Public Member Functions
void	ProcessNetworkLocationRequest(TUint, const TLbsExternalRequestInfo &, const TNotificationType &)
void	ProcessNetworkPositionUpdate(TUint, const TPositionInfo &)
void	ProcessRequestComplete(TUint, TInt)
IMPORT_C TVersion	Version()

Public Member Enumerations
enum	TNotificationType { ENotifyUnknown = 0, ENotifyLocationAccepted, ENotifyAndVerifyLocationAcceptedIfNoReponse, ENotifyAndVerifyLocationRejectedIfNoReponse, ENotifyLocationRejected }

Member Functions Documentation

ProcessNetworkLocationRequest(TUint, const TLbsExternalRequestInfo &, const TNotificationType &)

void	ProcessNetworkLocationRequest	(	TUint	aRequestId,
			const TLbsExternalRequestInfo &	aRequestInfo,
			const TNotificationType &	aNotificationType
		)	[pure virtual]

Called when a network location request is received by the LBS system. The implementer of this function must decide whether the location request is allowed and give the result to the LBS system. The result is passed by calling CPrivacyController::SendRequestVerificationResult().

TLbsExternalRequestInfo2 TLbsLocClassTypeBase::ClassType()

Parameters

TUint aRequestId	Identifies the request within the LBS system.
const TLbsExternalRequestInfo & aRequestInfo	Information about the external client making the request. Note that the actual type may be of one the derived classes e.g. TLbsExternalRequestInfo2. The type may be determined by calling ClassType(). If the class is of the TLbsExternalRequestInfo2 type, this parameter may be casted to access the extended information.
const TNotificationType & aNotificationType	The value set by the network for the user notification.

ProcessNetworkPositionUpdate(TUint, const TPositionInfo &)

void	ProcessNetworkPositionUpdate	(	TUint	aRequestId,
			const TPositionInfo &	aPosInfo
		)	[pure virtual]

Called whenever a position update is ready while processing a network location request. Typically, it will be called twice: 1) As soon as the network reference position is available. 2) As soon as the final calculated position is available.

Parameters

TUint aRequestId	Identifies the request within the LBS system.
const TPositionInfo & aPosInfo	The latest position data.

ProcessRequestComplete(TUint, TInt)

void	ProcessRequestComplete	(	TUint	aRequestId,
			TInt	aReason
		)	[pure virtual]

Called when a network location request (e.g. MT-LR) has been completed.

Parameters

TUint aRequestId	Identifies the request within the LBS system.
TInt aReason	Contains the reason for the completion of the request. Usually KErrNone, or a standard Symbian error code. KErrNotFound if aRequestId is not a currently active external location request.

Version()

IMPORT_C TVersion

Version

(

)

[virtual]

Returns the current version of the interface.

Member Enumerations Documentation

Enum TNotificationType

Contains the user notification action defined by the network location request (MT-LR). This setting may be overridden by the setting(s) in the LBS Admin Settings API.

CLbsAdmin::TExternalLocateService CLbsAdmin::TPrivacyTimeoutAction

Enumerators

ENotifyUnknown = 0	Unused/Unknown notification.
ENotifyLocationAccepted	Accept and notify user.
ENotifyAndVerifyLocationAcceptedIfNoReponse	Verify (query user). Accept if no response.
ENotifyAndVerifyLocationRejectedIfNoReponse	Verify (query user). Reject if no response.
ENotifyLocationRejected	Reject and notify user.