Symbian3/PDK/Source/GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 16 Jul 2010 17:23:46 +0100
changeset 12 80ef3a206772
parent 9 59758314f811
child 14 578be2adaf3e
permissions -rw-r--r--
Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     1
<?xml version="1.0" encoding="utf-8"?>
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     2
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     3
<!-- This component and the accompanying materials are made available under the terms of the License 
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     4
"Eclipse Public License v1.0" which accompanies this distribution, 
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     5
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     6
<!-- Initial Contributors:
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     7
    Nokia Corporation - initial contribution.
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     8
Contributors: 
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     9
-->
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    10
<!DOCTYPE concept
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    11
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    12
<concept xml:lang="en" id="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140"><title>Privacy Data Types</title><prolog><metadata><keywords/></metadata></prolog><conbody><section><title>Purpose</title> <p>  This document describes the classes and types of the Privacy Data Types that are used by the LBS Privacy Q&amp;N Notifiers. </p> </section> <section><title>Contents</title> <ul><li id="GUID-B53B02D5-777C-5E46-AF5C-C036D1239F6B"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-B81EACA1-BC5A-5DDF-A93C-F7A19DB14D57">Introduction</xref>  </p> </li> <li id="GUID-2C9E7947-5213-5588-9B6F-542534029E97"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-1E11995F-FEE5-5FD1-87E0-E9D035BD9367">API description</xref>  </p> <ul><li id="GUID-8FF26922-8C69-5091-9178-300AC2F12B80"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-1378C4C8-BBCE-5452-9D01-7AED7B867816">CPosRequestor</xref>  </p> </li> <li id="GUID-A96E58AB-40E8-5697-A42C-34CAF8D9122A"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-9AA0AD0E-A04C-5C71-980D-9F4E4B470F99">CPosServiceRequestor</xref> </p> </li> <li id="GUID-D54C00BD-838C-5890-8BA6-0574B3708B65"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-6D8EC945-5331-516C-B319-2104D6BA4022">CPosContactRequestor</xref> </p> </li> <li id="GUID-2D593D16-32BC-5C22-875F-5629A45DA98D"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-B156EAC5-D877-584F-8634-690645DC0F5C">RPosRequestorStack</xref>  </p> </li> <li id="GUID-903D6D72-D73D-5AB3-BB03-E893436091B9"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-270E155F-8E20-551A-AF43-6B68363E039C">TPosRequestSource</xref>  </p> </li> <li id="GUID-A43DD96C-725D-5886-B1CF-BA6C0FD8FC18"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-EE4A2044-AF18-57F8-A586-91A5D531DD45">TPosRequestDecision</xref>  </p> </li> <li id="GUID-0EDAD9F5-B0BC-5387-A5C1-7D2AC67FEB4B"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-852EC187-332B-5B25-9A1B-94CA875C2B4C">TPosNotificationReason</xref> </p> </li> <li id="GUID-6FBAA486-0335-5DE0-A6D7-20343AD688B9"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-80BD9F8E-1E87-5E3B-8E62-1B42987C83A4">TPosVerifyCancelReason</xref> </p> </li> </ul> </li> <li id="GUID-A09E1B03-9BC2-510C-9B04-9281B8810722"><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-4279E9B0-3376-5E0A-82A6-BE73DA466B5F">See also</xref>  </p> </li> </ul> </section> <section id="GUID-B81EACA1-BC5A-5DDF-A93C-F7A19DB14D57"><title>Introduction</title> <p>Figure 1 shows the Privacy Data Types within the <xref href="GUID-D18B4715-3942-52EA-9D2F-E145037FA47A.dita">Full LBS configuration</xref>. The Privacy Data Types are used to pass privacy request data and privacy response data between the LBS subsystem and licensee Privacy Q&amp;N Notifier classes. </p> <p>For a privacy request passed from the LBS subsystem to a Privacy Q&amp;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. </p> <p>Note that the Privacy Data Types are used only by the <xref href="GUID-8226320F-2F3A-575F-9950-B98C67472DAD.dita#GUID-8226320F-2F3A-575F-9950-B98C67472DAD/GUID-700B8644-A19F-5E0C-A1A8-E00CB2829229">Privacy Q&amp;N Notifiers</xref> API and are not used by the standard LBS Privacy Notifiers or the Privacy Controller, which are also shown in figure 1. </p> <p>Note also that although figure 1 shows a (partial) Full LBS Mode configuration, the Privacy Q&amp;N Notifiers and their associated Privacy Data Types can also be included in the <xref href="GUID-D18B4715-3942-52EA-9D2F-E145037FA47A.dita">Standalone Privacy Mode configuration</xref>. </p> <p>See <xref href="GUID-8226320F-2F3A-575F-9950-B98C67472DAD.dita#GUID-8226320F-2F3A-575F-9950-B98C67472DAD/GUID-700B8644-A19F-5E0C-A1A8-E00CB2829229">Privacy Q&amp;N Notifiers</xref> for examples of how the Privacy Data Types are used. </p> <fig id="GUID-D2E6E362-7A9F-5B43-87A1-8B3F6F30D49E"><title>
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    13
             Figure 1. The Privacy Data Types and related LBS subsystem
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    14
             components. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    15
          </title> <image href="GUID-2565AD08-6D97-5EF5-9CA2-83D6A953D772_d0e437561_href.png" placement="inline"/></fig> </section> <section id="GUID-1E11995F-FEE5-5FD1-87E0-E9D035BD9367"><title>API description</title> <p><b>Privacy Data Types class diagram </b> </p> <p>Figure 2 shows the classes and types of the Privacy Data Types. </p> <fig id="GUID-D871288E-3775-5868-9DFE-54CD060C2E4C"><title>
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    16
             Figure 2. Classes and types of the Privacy Data Types. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    17
          </title> <image href="GUID-94984754-A724-57C4-9E18-33B951F917B6_d0e437580_href.png" placement="inline"/></fig> <p><b>List of Privacy Data Types classes and types </b> </p> <p>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. </p> <p>The Privacy Data Types have <codeph>publishedPartner</codeph> interface access. </p> <table id="GUID-3B68A9CD-3031-564B-A80B-2B5D93AEAEF9"><tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><thead><row><entry>Class name</entry> <entry>Description</entry> <entry>Header file</entry> </row> </thead> <tbody><row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-B156EAC5-D877-584F-8634-690645DC0F5C">RPosRequestorStack</xref>  </p> </entry> <entry><p>An array of <codeph>CPosRequestor</codeph> objects. </p> </entry> <entry><p> <filepath>EPos_RPosRequestorStack.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-1378C4C8-BBCE-5452-9D01-7AED7B867816">CPosRequestor</xref>  </p> </entry> <entry><p>The base class that represents an agent (such as a contact or service) involved in a privacy request. Derived classes are <xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-9AA0AD0E-A04C-5C71-980D-9F4E4B470F99">CPosServiceRequestor</xref> and <xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-6D8EC945-5331-516C-B319-2104D6BA4022">CPosContactRequestor</xref>. A privacy requester is identified by a string which represents a contact number, URL, email address etc. </p> </entry> <entry><p> <filepath>EPos_CPosRequestor.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-9AA0AD0E-A04C-5C71-980D-9F4E4B470F99">CPosServiceRequestor</xref> </p> </entry> <entry><p>The derived class that represents a service privacy requester (such as a network service). </p> </entry> <entry><p> <filepath>EPos_CPosServiceRequestor.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-6D8EC945-5331-516C-B319-2104D6BA4022">CPosContactRequestor</xref> </p> </entry> <entry><p>The derived class that represents a contact privacy requester (such as a phone number or email address). </p> </entry> <entry><p> <filepath>EPos_CPosContactRequestor.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-270E155F-8E20-551A-AF43-6B68363E039C">TPosRequestSource</xref>  </p> </entry> <entry><p>Specifies the source of the privacy request. </p> </entry> <entry><p> <filepath>EPos_Privacy.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-EE4A2044-AF18-57F8-A586-91A5D531DD45">TPosRequestDecision</xref>  </p> </entry> <entry><p>Specifies if a privacy request was accepted or rejected by a Privacy Q&amp;N notifier. </p> </entry> <entry><p> <filepath>EPos_Privacy.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-852EC187-332B-5B25-9A1B-94CA875C2B4C">TPosNotificationReason</xref> </p> </entry> <entry><p>Specifies the reason why a privacy notification was sent into LBS. </p> </entry> <entry><p> <filepath>EPos_Privacy.h</filepath>  </p> </entry> </row> <row><entry><p><xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-80BD9F8E-1E87-5E3B-8E62-1B42987C83A4">TPosVerifyCancelReason</xref> </p> </entry> <entry><p>Specifies the reason why a privacy request was cancelled. </p> </entry> <entry><p> <filepath>EPos_Privacy.h</filepath>  </p> </entry> </row> </tbody> </tgroup> </table> <p><b>Libraries </b> </p> <p>The Privacy Data Types are packaged in <filepath>eposprvtyp.dll</filepath>. A client (a Privacy Q&amp;N Notifier) links to <filepath>eposprvtyp.lib</filepath>. </p> <p><b>Capabilities </b> </p> <p>Use of the Privacy Data Types requires no capabilities. </p> <p id="GUID-1378C4C8-BBCE-5452-9D01-7AED7B867816"><b>CPosRequestor</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita"><apiname> CPosRequestor</apiname></xref> is the base class that represents the agent (known as the <i>requester</i>) that is making a privacy request. Requesters are classified as either <i>service</i> or <i>contact</i> and these are represented by the derived classes <xref href="GUID-05250819-073D-3627-958A-4AB36939B58A.dita"><apiname>CPosServiceRequestor</apiname></xref> and <xref href="GUID-5730E9C2-CD6A-3E04-8F5F-FB1F42D44C46.dita"><apiname>CPosContactRequestor</apiname></xref>. </p> <p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita"><apiname>CPosRequestor</apiname></xref> has the following attributes: </p> <ul><li id="GUID-6892A398-714C-5C65-A4C0-44104AD2363B"><p>The requester type </p> <p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-708907E4-30DC-3F5E-AB02-9B1D95CCCC6A"><apiname>CPosRequestor::TRequestorType</apiname></xref> specifies the type of requester: a service or contact. </p> </li> <li id="GUID-ABB60FFC-A19E-555D-8300-31BBDF38D209"><p>The ID descriptor </p> <p>A descriptor variable specifies the ID of the requester. </p> </li> <li id="GUID-C36962FB-CC2B-5527-B811-E4BE3DBF3376"><p>The ID format </p> <p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-973896EC-CB0F-3FA1-AE52-A8B625882E1E"><apiname>CPosRequestor::TRequestorIdFormat</apiname></xref> specifies the type of data that the ID string contains, such as a name, a contact number or an email address. </p> </li> <li id="GUID-20143CCB-43B9-5536-B1AC-4EF827E19FA4"><p>The network type </p> <p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-3D9E27B9-A352-33A3-A317-F09879232C79"><apiname>CPosRequestor::_TNetworkType</apiname></xref> specifies whether a request is received over a GSM network or SUPL. </p> </li> <li id="GUID-AF439C9A-7B3B-54D2-8BD5-A9E37A493379"><p>The request type </p> <p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-F26E3F8D-033B-3292-8777-A99E493CEF75"><apiname>CPosRequestor::_TRequestType</apiname></xref> specifies if a request is single shot, periodic or an area event. </p> <p>Note that this property is not currently used within the LBS subsystem, but is defined for future use. </p> </li> </ul> <p><b>Usage </b> </p> <p>To send a privacy request to a Privacy Q&amp;N Notifier the LBS subsystem instantiates one of the derived classes <xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-9AA0AD0E-A04C-5C71-980D-9F4E4B470F99">CPosServiceRequestor</xref> (for a request from a service) or <xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-6D8EC945-5331-516C-B319-2104D6BA4022">CPosContactRequestor</xref> (for a request from a contact), setting the attributes listed above. </p> <p>Note that not all information about a privacy request that may be required by the notifier is passed to it in the <codeph>CPosRequestor</codeph> object. The enumerations <xref href="GUID-E4C7354B-3F7F-3279-AD6E-BA9574AD3A47.dita"><apiname>TPosNotificationReason</apiname></xref>, <xref href="GUID-B2BA5881-DCF9-305B-A192-9F90CBA6BD55.dita"><apiname>TPosRequestSource</apiname></xref> and <xref href="GUID-5836362B-C341-311E-ABBE-D403DFA0DD62.dita"><apiname>TPosRequestDecision</apiname></xref> shown in figure 1 also describe request data. These are set directly by the LBS subsystem on the Privacy Q&amp;N notifier (derived from <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita"><apiname>CPosPrivacyNotifier</apiname></xref>) when it is started. See <xref href="GUID-8226320F-2F3A-575F-9950-B98C67472DAD.dita#GUID-8226320F-2F3A-575F-9950-B98C67472DAD/GUID-700B8644-A19F-5E0C-A1A8-E00CB2829229">Privacy Q&amp;N Notifiers</xref> for more information. </p> <p>The LBS subsystem starts a Privacy Q&amp;N Notifier plug-in to display the privacy request information to the user. The notifier extracts request information by calling: </p> <ul><li id="GUID-91ECCED3-8F16-5AB9-AFB1-BDDFDB4A8684"><p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-1EAED876-8A9F-36F2-87A1-D26ADD7ADD45"><apiname>CPosRequestor::RequestorType()</apiname></xref> to get the type of requester: a service or contact </p> </li> <li id="GUID-E4170E9B-1B3F-5154-8538-7C0E60EB1DE9"><p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-62B84884-BC38-3A64-A766-152FBA8D940B"><apiname>CPosRequestor::RequestorIdString()</apiname></xref> to get the requester ID descriptor </p> </li> <li id="GUID-CE558FBC-DA5B-5977-994F-3C39D9915805"><p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-C5701A88-8E52-3790-89FC-B524A80B17CA"><apiname>CPosRequestor::RequestorIdFormat()</apiname></xref> to get the format of the requester ID contained in <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-62B84884-BC38-3A64-A766-152FBA8D940B"><apiname>CPosRequestor::RequestorIdString()</apiname></xref>  </p> </li> <li id="GUID-25F824A4-C929-58B3-8383-24F3CCC0591D"><p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-EBFDCEE7-ECCD-397E-AD87-47F36F5A3B71"><apiname>CPosRequestor::NetworkType()</apiname></xref> to get the network type </p> </li> <li id="GUID-FFA5A457-FBA6-5940-8EBC-CEB2F681D1D0"><p> <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita#GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3/GUID-51B8E4EC-5F3A-3EB6-9CE5-343E2C5570DD"><apiname>CPosRequestor::RequestType()</apiname></xref> to get the type of request </p> </li> </ul> <p>Information about the reason the notification was sent, the request source and the request timeout strategy is obtained directly from the <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita"><apiname>CPosPrivacyNotifier</apiname></xref> derived notifier by calling: </p> <ul><li id="GUID-117AF757-4367-5413-8DB9-32A4A7D93E95"><p> <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-22FFC3B2-A6B9-3501-AD89-1DB31027F53C"><apiname>CPosPrivacyNotifier::NotificationReason()</apiname></xref> to get the reason the notification request was sent </p> </li> <li id="GUID-57237383-1689-5CB9-9675-F6B24AE160D2"><p> <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-4EFE3E2B-92A4-3DC2-A02B-4AEE260DD682"><apiname>CPosPrivacyNotifier::RequestSource()</apiname></xref> to get the source of the request </p> </li> <li id="GUID-57DE6AE7-AB5C-5AA0-9DBC-BC52C9B352FF"><p> <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-73244BA6-E796-383B-BA9F-507B25AA98EA"><apiname>CPosPrivacyNotifier::QueryTimeoutStrategy()</apiname></xref> to get the timeout strategy that was supplied as part of the privacy request. The strategy specifies whether a request should be accepted or rejected if the notifier times out. </p> </li> </ul> <p>See <xref href="GUID-8226320F-2F3A-575F-9950-B98C67472DAD.dita#GUID-8226320F-2F3A-575F-9950-B98C67472DAD/GUID-700B8644-A19F-5E0C-A1A8-E00CB2829229">Privacy Q&amp;N Notifiers</xref> for more information about <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita"><apiname>CPosPrivacyNotifier</apiname></xref>. </p> <p id="GUID-9AA0AD0E-A04C-5C71-980D-9F4E4B470F99"><b>CPosServiceRequestor</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-05250819-073D-3627-958A-4AB36939B58A.dita"><apiname>CPosServiceRequestor</apiname></xref> is the derived class that represents a service privacy requester (such as a network service). </p> <p><b>Usage </b> </p> <p>The LBS subsystem creates an instance of this class to pass information about a privacy request received from a service to a Privacy Q&amp;N Notifier. </p> <p>The class adds the static constructors <xref href="GUID-05250819-073D-3627-958A-4AB36939B58A.dita#GUID-05250819-073D-3627-958A-4AB36939B58A/GUID-C92E9D95-6040-380F-95E3-1E459FDB128E"><apiname>CPosServiceRequestor::NewL()</apiname></xref> and <xref href="GUID-05250819-073D-3627-958A-4AB36939B58A.dita#GUID-05250819-073D-3627-958A-4AB36939B58A/GUID-C4CFD65D-6B3D-3B5F-BC9A-BF7846BDEDA5"><apiname>CPosServiceRequestor::NewLC()</apiname></xref> to the base class <xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-1378C4C8-BBCE-5452-9D01-7AED7B867816">CPosRequestor</xref>. </p> <p id="GUID-6D8EC945-5331-516C-B319-2104D6BA4022"><b>CPosContactRequestor</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-5730E9C2-CD6A-3E04-8F5F-FB1F42D44C46.dita"><apiname> CPosContactRequestor</apiname></xref> is the derived class that represents a contact privacy requester (such as a phone number or email address). </p> <p><b>Usage </b> </p> <p>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&amp;N Notifier. </p> <p>The class adds the static constructors <xref href="GUID-5730E9C2-CD6A-3E04-8F5F-FB1F42D44C46.dita#GUID-5730E9C2-CD6A-3E04-8F5F-FB1F42D44C46/GUID-15F3CEF6-B635-37B9-9ECE-2BAE24B5ED65"><apiname>CPosContactRequestor::NewL()</apiname></xref> and <xref href="GUID-5730E9C2-CD6A-3E04-8F5F-FB1F42D44C46.dita#GUID-5730E9C2-CD6A-3E04-8F5F-FB1F42D44C46/GUID-943C2E1C-F379-32A0-8D20-61EB800BE3F7"><apiname>CPosContactRequestor::NewLC()</apiname></xref> to the base class <xref href="GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140.dita#GUID-3170E641-E3A9-58D5-82B9-391A2F5AC140/GUID-1378C4C8-BBCE-5452-9D01-7AED7B867816">CPosRequestor</xref>. </p> <p id="GUID-B156EAC5-D877-584F-8634-690645DC0F5C"><b>RPosRequestorStack</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-1349F419-EDB4-303C-A3CA-AD9D061FC91C.dita"><apiname>RPosRequestorStack</apiname></xref> is an array of <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita"><apiname>CPosRequestor</apiname></xref> objects. </p> <p><b>Usage </b> </p> <p>The LBS subsystem creates an <xref href="GUID-1349F419-EDB4-303C-A3CA-AD9D061FC91C.dita"><apiname>RPosRequestorStack</apiname></xref> instance populated with <xref href="GUID-4093F252-99F9-3B2B-AA8B-68C635EF64D3.dita"><apiname>CPosRequestor</apiname></xref> derived objects when a privacy request is received. This stack object is passed to a Privacy Q&amp;N Notifier. See <xref href="GUID-8226320F-2F3A-575F-9950-B98C67472DAD.dita#GUID-8226320F-2F3A-575F-9950-B98C67472DAD/GUID-700B8644-A19F-5E0C-A1A8-E00CB2829229">Privacy Q&amp;N Notifiers</xref> for more information about the use of <xref href="GUID-1349F419-EDB4-303C-A3CA-AD9D061FC91C.dita"><apiname>RPosRequestorStack</apiname></xref>. </p> <p id="GUID-270E155F-8E20-551A-AF43-6B68363E039C"><b>TPosRequestSource</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-B2BA5881-DCF9-305B-A192-9F90CBA6BD55.dita"><apiname>TPosRequestSource</apiname></xref> specifies the source of a privacy request. This enumeration defines two values for a network source and for an unknown source. </p> <p><b>Usage </b> </p> <p>Set by the LBS subsystem on a Privacy Q&amp;N notifier plug-in when it is started to specify the source of the request. <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-4EFE3E2B-92A4-3DC2-A02B-4AEE260DD682"><apiname>CPosPrivacyNotifier::RequestSource()</apiname></xref> gets the value. </p> <p id="GUID-EE4A2044-AF18-57F8-A586-91A5D531DD45"><b>TPosRequestDecision</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-5836362B-C341-311E-ABBE-D403DFA0DD62.dita"><apiname>TPosRequestDecision</apiname></xref> specifies if a privacy request was accepted or rejected by a Privacy Q&amp;N notifier. </p> <p><b>Usage </b> </p> <ul><li id="GUID-C2201640-1DCF-50EC-92F5-32E717C061E6"><p>Set by the LBS subsystem to specify the privacy response that should be made if a Privacy Q&amp;N notifier times out. <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-73244BA6-E796-383B-BA9F-507B25AA98EA"><apiname>CPosPrivacyNotifier::QueryTimeoutStrategy()</apiname></xref> gets the value which can be to either accept or reject the request. </p> </li> <li id="GUID-636190B1-B4AF-5094-ABC3-90136F78C1E7"><p>Set by a Privacy Q&amp;N Notifier to specify the privacy response. <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-DDAC932E-1093-38AB-8CA6-3B2B06CC2BC0"><apiname>CPosPrivacyNotifier::LocationRequestDecision()</apiname></xref> gets the value set by the notifier. </p> </li> </ul> <p id="GUID-852EC187-332B-5B25-9A1B-94CA875C2B4C"><b>TPosNotificationReason</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-E4C7354B-3F7F-3279-AD6E-BA9574AD3A47.dita"><apiname>TPosNotificationReason</apiname></xref> specifies the reason why a notification message was received from the network: </p> <p>A notification can be received for the following reasons: </p> <ul><li id="GUID-9F352245-B298-594A-B251-3515758ABA03"><p>A privacy verification (sent previously) has timed out and the user needs to be notified of this fact. </p> </li> <li id="GUID-20752DE6-7C53-57D8-BDC0-68DC807CE1AB"><p>A location request was either accepted or rejected by the request source. </p> </li> <li id="GUID-C01869C1-5A79-59DC-BA0D-52F24C88D556"><p>For an unknown reason. </p> </li> </ul> <p><b>Usage </b> </p> <p>Set by the LBS subsystem on a Privacy Q&amp;N Notifier to specify why a privacy notification was received. The value is obtained from the notifier by calling <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-22FFC3B2-A6B9-3501-AD89-1DB31027F53C"><apiname>CPosPrivacyNotifier::NotificationReason()</apiname></xref>. </p> <p id="GUID-80BD9F8E-1E87-5E3B-8E62-1B42987C83A4"><b>TPosVerifyCancelReason</b> </p> <p><b>Purpose </b> </p> <p> <xref href="GUID-8E445582-5821-36B3-A8FB-EE706D7C40EF.dita"><apiname>TPosVerifyCancelReason</apiname></xref> specifies the reason why a privacy verification request was cancelled. </p> <p><b>Usage </b> </p> <p>Set by the LBS subsystem on a Privacy Q&amp;N Notifier to specify why a privacy verification request was cancelled. The value is obtained from the notifier by calling <xref href="GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C.dita#GUID-56C8D5AB-7D9A-3B20-B699-07F17A87A61C/GUID-54EB2437-9070-376D-8FCD-C1D4758113E6"><apiname>CPosPrivacyNotifier::CancelReason()</apiname></xref>. </p> </section> </conbody></concept>