| class TLbsPrivacyRequest : public TLbsPrivacyClassTypeBase |
A class that wraps privacy request parameters.
An instance of the class TLbsPrivacyRequest is passed to the LBS subsystem when a local or remote privacy request is sent via the Privacy Request API. The class is used to indicate what advice should be given to the user. For example, this may advise that the user is required to verify the request or is simply notified about it.
The class also specifies whether the request should be accepted or rejected. In the situation where the user must verify the request, 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 LBS subsystem should automatically accept the request.
Alternatively, the user may be notified that a request has been rejected. In this situation the advice is set to ERequestAdviceNotify with an action of ERequestActionReject.
| Public Member Functions | |
|---|---|
| TLbsPrivacyRequest () | |
| IMPORT_C TLbsRequestAction | RequestAction () |
| IMPORT_C TLbsRequestAdvice | RequestAdvice () |
| IMPORT_C void | SetRequestAction ( TLbsRequestAction ) |
| IMPORT_C void | SetRequestAdvice ( TLbsRequestAdvice ) |
| Inherited Functions | |
|---|---|
| TLbsPrivacyClassTypeBase::ClassSize()const | |
| TLbsPrivacyClassTypeBase::ClassType()const | |
| TLbsPrivacyClassTypeBase::TLbsPrivacyClassTypeBase(TUint32,TUint) | |
| Public Member Enumerations | |
|---|---|
| enum | _TLbsRequestAction { ERequestActionNotUsed = 0, ERequestActionAllow , ERequestActionReject } |
| enum | _TLbsRequestAdvice { ERequestAdviceNotUsed = 0, ERequestAdviceNotify , ERequestAdviceVerify , ERequestAdviceSilent , ERequestAdviceStealth } |
| Public Member Type Definitions | |
|---|---|
| typedef | TUint32 TLbsRequestAction |
| typedef | TUint32 TLbsRequestAdvice |
| Protected Attributes | |
|---|---|
| TLbsRequestAction | iAction |
| TLbsRequestAdvice | iAdvice |
| TUint8 | iReserved |
| Inherited Attributes | |
|---|---|
| TLbsPrivacyClassTypeBase::iClassSize | |
| TLbsPrivacyClassTypeBase::iClassType | |
| IMPORT_C TLbsRequestAction | RequestAction | ( | ) | const |
Returns for the request action. Value returned is from enumeration TLbsPrivacyRequest::_TLbsRequestAction
| IMPORT_C TLbsRequestAdvice | RequestAdvice | ( | ) | const |
Returns the request advice. Value returned is from enumeration TLbsPrivacyRequest::_TLbsRequestAdvice
| IMPORT_C void | SetRequestAction | ( | TLbsRequestAction | aAction | ) |
Setter for the request action.
| TLbsRequestAction aAction |
| IMPORT_C void | SetRequestAdvice | ( | TLbsRequestAdvice | aAdvice | ) |
Sets for the request advice.
| TLbsRequestAdvice aAdvice | The request advice to be set. Must be from enum TLbsPrivacyRequest::_TLbsRequestAdvice |
Note that the TLbsRequestAction enum may be extended in the future by adding more enumerated values. To maintain compatibility any unrecognized values must be handled as ERequestActionNotUsed.
| ERequestActionNotUsed = 0 |
Not Used |
| 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. In most situations the privacy response of the user should be used to decide whether to accept a location request. Therefore in most cases a privacy advice of ERequestAdviceNotify and a privacy action of ERequestActionAllow should not be used together, although it is not an error to do so. |
| 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 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. |
Note that the TLbsRequestAdvice enum may be extended in the future by adding more enumerated values. To maintain compatibility any unrecognized values must be handled as ERequestAdviceNotUsed.
| 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 the request. |
| ERequestAdviceSilent |
The LBS subsystem should neither notify or query the user if they wish to accept or reject a request. Details of the request should be logged. |
| ERequestAdviceStealth |
No indication should be given to a user. The user should neither be notified nor queried. In addition, no information about the request should be logged. This option is defined by some network 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.