TLbsNetPosRequestPrivacy Class Reference

class TLbsNetPosRequestPrivacy : public TLbsNetClassTypeBase

Privacy procedure requested by the network.

An instance of the class TLbsNetPosRequestPrivacy is passed to the LBS subsystem in the method MLbsNetworkProtocolObserver::ProcessPrivacyRequest(). The class is used to indicate what advice should be given to the user. For example, this may advise that the user is consulted over the request or simply notified about it.

The class also specifies whether the request should be accepted or rejected. In the situation where the user is consulted, the action is the default behaviour when the user does not respond.

For example, if the advice is set to ERequestAdviceVerify and the action is ERequestActionAllow, this indicates that the user should be asked if they wish to accept or reject the request. However, if the user does not respond, the terminal should automatically accept the request.

Alternatively, the network may wish to advise the terminal that it has rejected a location request designated for the device. In this situation the advice is set to ERequestAdviceNotify with an action of ERequestActionReject.

MLbsNetworkProtocolObserver::ProcessPrivacyRequest

Inherits from

Constructor & Destructor Documentation

TLbsNetPosRequestPrivacy()

IMPORT_CTLbsNetPosRequestPrivacy()

Constructor for the TLbsNetPosRequestPrivacy

CLbsLocationSourceGpsBase

Member Functions Documentation

RequestAction()

IMPORT_C TLbsRequestActionRequestAction()const

Returns the network's recomendation on whether the location request should be accepted or rejected. In the situation where the user is consulted, the action is the default behaviour when the user does not respond.

RequestAdvice MLbsNetworkProtocolObserver::ProcessPrivacyRequest

RequestAdvice()

IMPORT_C TLbsRequestAdviceRequestAdvice()const

Returns the networks recomendation on whether the user is to be consulted, simply notified, or potentially not advised about the request for their location.

RequestAction MLbsNetworkProtocolObserver::ProcessPrivacyRequest

SetRequestAction(TLbsRequestAction)

IMPORT_C voidSetRequestAction(TLbsRequestActionaAction)

Assigns which action (reject/accept) the network has recomended for a location request.

RequestAction SetRequestAdvice MLbsNetworkProtocolObserver::ProcessPrivacyRequest

Parameters

TLbsRequestAction aActioncontains the recomended action.

SetRequestAdvice(TLbsRequestAdvice)

IMPORT_C voidSetRequestAdvice(TLbsRequestAdviceaAdvice)

Assigns which advice (verify/notify/silent) the network has recomended for a location request.

RequestAdvice SetRequestAction MLbsNetworkProtocolObserver::ProcessPrivacyRequest

Parameters

TLbsRequestAdvice aAdvicecontains the recomended advice.

Member Enumerations Documentation

Enum TLbsRequestAction

Enumerators

ERequestActionNotUsed = 0

Must not be used with an exception of marking uninitialized values. The protocol must not send this value to the LBS as a privacy request parameters.

ERequestActionAllow

The default action for LBS subsystem should be to accept the request. If this value is passed in combination with ERequestAdviceVerify, it indicates that the user should be asked if they wish to accept or reject the request. However, if the user does not respond, the request should be allowed.

ERequestActionReject

The default action for LBS subsystem should be to reject the request. If this value is passed in combination with ERequestAdviceVerify, it indicates that the user should be asked if they wish to accept or reject the request. However, if the user does not respond, the request should be rejected.

If ERequestActionReject is passed in combination with ERequestAdviceNotify, it indicates that the user should be informed that a request has been made but the terminal should automatically reject it.

Enum TLbsRequestAdvice

Enumerators

ERequestAdviceNotUsed = 0

Not Used

ERequestAdviceNotify

The LBS subsystem should notify the user that their location has been requested.

ERequestAdviceVerify

The LBS subsystem should ask the user if they wish to accept or reject an external request.

ERequestAdviceSilent

The LBS subsystem should neither notify or query the user if they wish to accept or reject an external request. Details of the request should be logged.

ERequestAdviceStealth

The terminal should no indication that the device's location is being determined by an external party. The user should neither be notified nor queried. In addition, no information about the request should be logged. This option is defined by some protocols (e.g. SUPL) but is not implemented by the LBS subsystem.

Member Data Documentation

TLbsRequestAction iAction

TLbsRequestAction iAction[protected]

TLbsRequestAdvice iAdvice

TLbsRequestAdvice iAdvice[protected]

TUint8 iReserved

TUint8 iReserved[protected]