MLbsPrivacyObserver Class Reference

#include <lbs/lbsprivacycontroller.h>

Link against: lbsprivacycontroller.lib

class MLbsPrivacyObserver

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

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

Detailed Description

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.

Member Enumeration 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.

See also: CLbsAdmin::TExternalLocateService CLbsAdmin::TPrivacyTimeoutAction

Enumerator	Value	Description
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.

Member Function 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().

Parameter	Description
aRequestId	Identifies the request within the LBS system.
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.
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.

Parameter	Description
aRequestId	Identifies the request within the LBS system.
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.

Parameter	Description
aRequestId	Identifies the request within the LBS system.
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.

Returns: The current version of the interface.