MLbsPrivacyRequestObserver Class Reference

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

Member Functions Documentation

ExtendedInterface(TInt, TAny *, TAny *)

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.

Parameters

TInt aFunctionNumber
TAny * aPtr1
TAny * aPtr2

OnPrivacyResponse(TLbsPrivacyRequestId, const TLbsPrivacyResponse &, TInt)

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

Parameters

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.

Version()

IMPORT_C TVersion Version ( ) const [virtual]

Class version control.

Member Enumerations Documentation

Enum _TLbsPrivacyResponse

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.

Enumerators

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

Member Type Definitions Documentation

Typedef TLbsPrivacyResponse

typedef TUint32 TLbsPrivacyResponse

Defined type for TLbsPrivacyResponse