This document describes the classes and types of the Privacy Data Types that are used by the LBS Privacy Q&N Notifiers.
Figure 1 shows the Privacy Data Types within the
For a privacy request passed from the LBS subsystem to a Privacy Q&N Notifier, the Privacy Data Types specify the agent that is making the request (the requester) and the type of the request. For a privacy response, the Privacy Data Types specify why a privacy request was accepted, rejected or cancelled by a user.
Note that the Privacy Data Types are used only by the
Note also that although figure 1 shows a (partial) Full LBS Mode configuration, the Privacy Q&N Notifiers and their associated Privacy Data Types can also be included in the
See
Privacy Data Types class diagram
Figure 2 shows the classes and types of the Privacy Data Types.
List of Privacy Data Types classes and types
The following table lists the main classes and types of the Privacy Data Types. Further details can be found by following the links to other sections of this document and to Symbian Developer Library reference documentation.
The Privacy Data Types have
Libraries
The Privacy Data Types are packaged in
Capabilities
Use of the Privacy Data Types requires no capabilities.
CPosRequestor
Purpose
The requester type
The ID descriptor
A descriptor variable specifies the ID of the requester.
The ID format
The network type
The request type
Note that this property is not currently used within the LBS subsystem, but is defined for future use.
Usage
To send a privacy request to a Privacy Q&N Notifier the LBS subsystem instantiates one of the derived classes
Note that not all information about a privacy request that may be required by the notifier is passed to it in the
The LBS subsystem starts a Privacy Q&N Notifier plug-in to display the privacy request information to the user. The notifier extracts request information by calling:
Information about the reason the notification was sent, the request source and the request timeout strategy is obtained directly from the
See
CPosServiceRequestor
Purpose
Usage
The LBS subsystem creates an instance of this class to pass information about a privacy request received from a service to a Privacy Q&N Notifier.
The class adds the static constructors
CPosContactRequestor
Purpose
Usage
The LBS subsystem creates an instance of this class to pass information about a privacy request received from a contact (such as a telephone number or email address) to a Privacy Q&N Notifier.
The class adds the static constructors
RPosRequestorStack
Purpose
Usage
The LBS subsystem creates an
TPosRequestSource
Purpose
Usage
Set by the LBS subsystem on a Privacy Q&N notifier plug-in when it is started to specify the source of the request.
TPosRequestDecision
Purpose
Usage
Set by the LBS subsystem to specify the privacy response that should be made if a Privacy Q&N notifier times out.
Set by a Privacy Q&N Notifier to specify the privacy response.
TPosNotificationReason
Purpose
A notification can be received for the following reasons:
A privacy verification (sent previously) has timed out and the user needs to be notified of this fact.
A location request was either accepted or rejected by the request source.
For an unknown reason.
Usage
Set by the LBS subsystem on a Privacy Q&N Notifier to specify why a privacy notification was received. The value is obtained from the notifier by calling
TPosVerifyCancelReason
Purpose
Usage
Set by the LBS subsystem on a Privacy Q&N Notifier to specify why a privacy verification request was cancelled. The value is obtained from the notifier by calling
This document describes the classes and types of the Privacy Data Types that are used by the LBS Privacy Q&N Notifiers.
Figure 1 shows the Privacy Data Types within the
For a privacy request passed from the LBS subsystem to a Privacy Q&N Notifier, the Privacy Data Types specify the agent that is making the request (the requester) and the type of the request. For a privacy response, the Privacy Data Types specify why a privacy request was accepted, rejected or cancelled by a user.
Note that the Privacy Data Types are used only by the
Note also that although figure 1 shows a (partial) Full LBS Mode configuration, the Privacy Q&N Notifiers and their associated Privacy Data Types can also be included in the
See
Privacy Data Types class diagram
Figure 2 shows the classes and types of the Privacy Data Types.
List of Privacy Data Types classes and types
The following table lists the main classes and types of the Privacy Data Types. Further details can be found by following the links to other sections of this document and to Symbian Developer Library reference documentation.
The Privacy Data Types have
Libraries
The Privacy Data Types are packaged in
Capabilities
Use of the Privacy Data Types requires no capabilities.
CPosRequestor
Purpose
The requester type
The ID descriptor
A descriptor variable specifies the ID of the requester.
The ID format
The network type
The request type
Note that this property is not currently used within the LBS subsystem, but is defined for future use.
Usage
To send a privacy request to a Privacy Q&N Notifier the LBS subsystem instantiates one of the derived classes
Note that not all information about a privacy request that may be required by the notifier is passed to it in the
The LBS subsystem starts a Privacy Q&N Notifier plug-in to display the privacy request information to the user. The notifier extracts request information by calling:
Information about the reason the notification was sent, the request source and the request timeout strategy is obtained directly from the
See
CPosServiceRequestor
Purpose
Usage
The LBS subsystem creates an instance of this class to pass information about a privacy request received from a service to a Privacy Q&N Notifier.
The class adds the static constructors
CPosContactRequestor
Purpose
Usage
The LBS subsystem creates an instance of this class to pass information about a privacy request received from a contact (such as a telephone number or email address) to a Privacy Q&N Notifier.
The class adds the static constructors
RPosRequestorStack
Purpose
Usage
The LBS subsystem creates an
TPosRequestSource
Purpose
Usage
Set by the LBS subsystem on a Privacy Q&N notifier plug-in when it is started to specify the source of the request.
TPosRequestDecision
Purpose
Usage
Set by the LBS subsystem to specify the privacy response that should be made if a Privacy Q&N notifier times out.
Set by a Privacy Q&N Notifier to specify the privacy response.
TPosNotificationReason
Purpose
A notification can be received for the following reasons:
A privacy verification (sent previously) has timed out and the user needs to be notified of this fact.
A location request was either accepted or rejected by the request source.
For an unknown reason.
Usage
Set by the LBS subsystem on a Privacy Q&N Notifier to specify why a privacy notification was received. The value is obtained from the notifier by calling
TPosVerifyCancelReason
Purpose
Usage
Set by the LBS subsystem on a Privacy Q&N Notifier to specify why a privacy verification request was cancelled. The value is obtained from the notifier by calling