| class MLbsPrivacyRequestObserver |
The MLbsPrivacyRequestObserver is an abstract interface to an external application and is used to pass privacy responses.
The MLbsPrivacyRequestObserver class is used in partnership with the CLbsPrivacyRequest interface class.
A concrete class must derive from MLbsPrivacyRequestObserver to provide the specific implementation of the interface methods.
CLbsPrivacyRequest
| Public Member Functions | |
|---|---|
| void | OnPrivacyResponse ( TLbsPrivacyRequestId , const TLbsPrivacyResponse &, TInt ) |
| IMPORT_C TVersion | Version () |
| Protected Member Functions | |
|---|---|
| IMPORT_C TAny * | ExtendedInterface ( TInt , TAny *, TAny *) |
| Public Member Enumerations | |
|---|---|
| enum | _TLbsPrivacyResponse { EPrivacyResponseUnknown = 0, EPrivacyResponseAccepted , EPrivacyResponseRejected , EPrivacyResponseIgnored } |
| Public Member Type Definitions | |
|---|---|
| typedef | TUint32 TLbsPrivacyResponse |
| IMPORT_C TAny * | ExtendedInterface | ( | TInt | aFunctionNumber, |
| TAny * | aPtr1, | |||
| TAny * | aPtr2 | |||
| ) | [protected, virtual] | |||
Should not be used. Provides for future expansion of the observer interface. Currently not implemented.
Should not be used. Provides for future expansion of the observer interface.
| void | OnPrivacyResponse | ( | TLbsPrivacyRequestId | aRequestId, |
| const TLbsPrivacyResponse & | aResponse, | |||
| TInt | aError | |||
| ) | [pure virtual] | |||
OnPrivacyResponse() is called by the LBS subsystem in response to an application issuing a privacy request on behalf of a local client or a network.
The method indicates to the application whether the terminal is willing to accept or has rejected the privacy request. This method is called for privacy verification and privacy notification requests and the request ID parameter indicates which request is being responded to by the LBS subsystem.
If a request is of the notification type, the response is usually identical to the default action passed as a parameter of a privacy request.
The privacy response is set to the value defined by CLbsAdmin::TPrivacyTimeoutAction if the privacy request times out and no default action was specified as part of the privacy request (CLbsAdmin::TPrivacyTimeoutAction. TLbsPrivacyResponse CLbsPrivacyRequest CLbsAdmin::TPrivacyTimeoutAction KLbsSettingMaximumExternalLocateRequests
| TLbsPrivacyRequestId aRequestId | [In] The Id of the privacy request associated with this privacy response |
| const TLbsPrivacyResponse & aResponse | [In] The result of the privacy check. |
| TInt aError | [In] KErrNone a request has been processed successfully, KErrArgument if the request parameters are incorrect, KErrServerBusy if calling CLbsPrivacyRequest::NewPrivacyRequest() causes the number of privacy requests to exceed the maximum number of privacy requests that can be handled simultaneously (as defined by KLbsSettingMaximumExternalLocateRequests), or any other system wide error code. |
The response to a privacy request. Note that the TLbsPrivacyResponse enum may be extended in the future by adding more enumerated values. To maintain compatibility any unrecognized values must be handled as EPrivacyResponseUnknown.
| EPrivacyResponseUnknown = 0 |
Not Used |
| EPrivacyResponseAccepted |
Inform the requestor the terminal will accept its location request |
| EPrivacyResponseRejected |
Inform the requestor the terminal will reject its location request |
| EPrivacyResponseIgnored |
Inform the application it should not respond to the location request. This option is currently not supported |
| typedef TUint32 | TLbsPrivacyResponse |
Defined type for TLbsPrivacyResponse
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.