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.

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.