| 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.
| Public Member Functions | |
|---|---|
| TLbsNetPosRequestPrivacy() | |
| IMPORT_C TLbsRequestAction | RequestAction() |
| IMPORT_C TLbsRequestAdvice | RequestAdvice() |
| IMPORT_C void | SetRequestAction(TLbsRequestAction) |
| IMPORT_C void | SetRequestAdvice(TLbsRequestAdvice) |
| Inherited Functions | |
|---|---|
| TLbsNetClassTypeBase::ClassSize()const | |
| TLbsNetClassTypeBase::ClassType()const | |
| TLbsNetClassTypeBase::TLbsNetClassTypeBase() | |
| Public Member Enumerations | |
|---|---|
| enum | TLbsRequestAction { ERequestActionNotUsed = 0, ERequestActionAllow, ERequestActionReject } |
| enum | TLbsRequestAdvice { ERequestAdviceNotUsed = 0, ERequestAdviceNotify, ERequestAdviceVerify, ERequestAdviceSilent, ERequestAdviceStealth } |
| Protected Attributes | |
|---|---|
| TLbsRequestAction | iAction |
| TLbsRequestAdvice | iAdvice |
| TUint8 | iReserved |
| Inherited Attributes | |
|---|---|
| TLbsNetClassTypeBase::iClassSize | |
| TLbsNetClassTypeBase::iClassType | |
| IMPORT_C | TLbsNetPosRequestPrivacy | ( | ) |
Constructor for the TLbsNetPosRequestPrivacy
CLbsLocationSourceGpsBase
| IMPORT_C TLbsRequestAction | RequestAction | ( | ) | 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
| IMPORT_C TLbsRequestAdvice | RequestAdvice | ( | ) | 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
| IMPORT_C void | SetRequestAction | ( | TLbsRequestAction | aAction | ) |
Assigns which action (reject/accept) the network has recomended for a location request.
RequestAction SetRequestAdvice MLbsNetworkProtocolObserver::ProcessPrivacyRequest
| TLbsRequestAction aAction | contains the recomended action. |
| IMPORT_C void | SetRequestAdvice | ( | TLbsRequestAdvice | aAdvice | ) |
Assigns which advice (verify/notify/silent) the network has recomended for a location request.
RequestAdvice SetRequestAction MLbsNetworkProtocolObserver::ProcessPrivacyRequest
| TLbsRequestAdvice aAdvice | contains the recomended advice. |
| 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. |
| 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. |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.