equal
deleted
inserted
replaced
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-12DA697C-1BB0-489F-98E1-F9B81E4A2F4D" xml:lang="en"><title>Creating |
12 <concept id="GUID-12DA697C-1BB0-489F-98E1-F9B81E4A2F4D" xml:lang="en"><title>Creating |
13 a Privacy Notification Notifier</title><shortdesc>To use the LBS Privacy Notifiers for privacy verification and privacy |
13 a Privacy Notification Notifier</title><shortdesc>To use the LBS Privacy Notifiers for privacy verification and privacy |
14 notification a licensee must implement a Privacy Notification Notifier. The |
14 notification a licensee must implement a Privacy Notification Notifier. The |
15 licensee should override the synchronous <apiname>MEikSrvNotifierBase2::StartL()</apiname> method |
15 licensee should override the synchronous <codeph>MEikSrvNotifierBase2::StartL()</codeph> method |
16 that does not return a response. This is because the user cannot send a response |
16 that does not return a response. This is because the user cannot send a response |
17 to a privacy notification. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
17 to a privacy notification. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
18 <p>This topic describes how to implement a Privacy Notification Notifier, |
18 <p>This topic describes how to implement a Privacy Notification Notifier, |
19 which is used to handle privacy notification requests. </p> |
19 which is used to handle privacy notification requests. </p> |
20 <p>The implementation of a Privacy Notification Notifier is similar to that |
20 <p>The implementation of a Privacy Notification Notifier is similar to that |
22 is passed for privacy notification as for privacy verification. The most notable |
22 is passed for privacy notification as for privacy verification. The most notable |
23 difference for privacy notification is that the synchronous method <xref href="GUID-2BA43B57-610F-324F-B5E0-590174A6D1BF.dita#GUID-2BA43B57-610F-324F-B5E0-590174A6D1BF/GUID-21C2E5DC-5DA4-35E3-A605-AE6DCB1BB3CE"><apiname>MEikSrvNotifierBase::StartL()</apiname></xref> is |
23 difference for privacy notification is that the synchronous method <xref href="GUID-2BA43B57-610F-324F-B5E0-590174A6D1BF.dita#GUID-2BA43B57-610F-324F-B5E0-590174A6D1BF/GUID-21C2E5DC-5DA4-35E3-A605-AE6DCB1BB3CE"><apiname>MEikSrvNotifierBase::StartL()</apiname></xref> is |
24 implemented. This is because the notifier is used only for privacy notification |
24 implemented. This is because the notifier is used only for privacy notification |
25 and it is not possible to respond to it. This makes implementation of the |
25 and it is not possible to respond to it. This makes implementation of the |
26 notifier easier. </p> |
26 notifier easier. </p> |
27 <section> <title>Defining the Privacy Notification Notifier</title> |
27 <section id="GUID-5A3C2A41-F6F1-4CBA-9DD0-180958C6B628"> <title>Defining the Privacy Notification Notifier</title> |
28 <p>The code below shows a definition of a Privacy Notification Notifier |
28 <p>The code below shows a definition of a Privacy Notification Notifier |
29 class. </p><p>The notifier owns a <codeph>CMyLBSPrivacyNotifierDialog</codeph> dialog |
29 class. </p><p>The notifier owns a <codeph>CMyLBSPrivacyNotifierDialog</codeph> dialog |
30 class to show details of the privacy request to the end user and to obtain |
30 class to show details of the privacy request to the end user and to obtain |
31 the response. </p><codeblock xml:space="preserve">/* |
31 the response. </p><codeblock xml:space="preserve">/* |
32 ============================================================================ |
32 ============================================================================ |
95 CMyLBSPrivacyNotifierDialog* iDlg; |
95 CMyLBSPrivacyNotifierDialog* iDlg; |
96 |
96 |
97 }; |
97 }; |
98 |
98 |
99 #endif // __MYLBSPRIVACYNOTIFIER_H__</codeblock> </section> |
99 #endif // __MYLBSPRIVACYNOTIFIER_H__</codeblock> </section> |
100 <section><title>Defining the Privacy Notification Dialog</title><p>The following |
100 <section id="GUID-27A3C22E-8222-4C09-95BE-7EE3F8F56C82"><title>Defining the Privacy Notification Dialog</title><p>The following |
101 is the definition of the dialog used by the example Privacy Notification Notifier: </p><codeblock xml:space="preserve">/* |
101 is the definition of the dialog used by the example Privacy Notification Notifier: </p><codeblock xml:space="preserve">/* |
102 ============================================================================ |
102 ============================================================================ |
103 Name : MyLBSPrivacyNotifier.cpp |
103 Name : MyLBSPrivacyNotifier.cpp |
104 Description : Source for LBS location notification notifier and dialog |
104 Description : Source for LBS location notification notifier and dialog |
105 ============================================================================ |
105 ============================================================================ |
185 maxlength = 25; |
185 maxlength = 25; |
186 }; |
186 }; |
187 } |
187 } |
188 }; |
188 }; |
189 }</codeblock></section> |
189 }</codeblock></section> |
190 <section><title>Notifier and dialog method implementations</title><p>Much |
190 <section id="GUID-67771BB3-D9E2-4368-8365-D1BB84CC43C7"><title>Notifier and dialog method implementations</title><p>Much |
191 of the implementation of a Privacy Notification Notifier is similar to that |
191 of the implementation of a Privacy Notification Notifier is similar to that |
192 for a Privacy Verification Notifier. The most relevant differences are in |
192 for a Privacy Verification Notifier. The most relevant differences are in |
193 the implementation of <xref href="GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0.dita#GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0/GUID-7863DC49-9664-390C-AAE1-B3BE043CA108"><apiname>MEikSrvNotifierBase2::RegisterL()</apiname></xref>, <xref href="GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0.dita#GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0/GUID-5DC8D35F-FFA5-3CE8-A06D-303A7E3ECC9B"><apiname>MEikSrvNotifierBase2::StartL()</apiname></xref> and <xref href="GUID-DC21E927-18B3-3BBF-9B67-496F2D158B03.dita#GUID-DC21E927-18B3-3BBF-9B67-496F2D158B03/GUID-6AFDB981-BBA2-3A5E-A7A5-BA6B39BC4CE9"><apiname>CEikDialog::OkToExitL()</apiname></xref>. </p><p>The value KLbsExtLocationRequestNotifyUid as defined in lbsextprivacynotifiers.h |
193 the implementation of <xref href="GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0.dita#GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0/GUID-7863DC49-9664-390C-AAE1-B3BE043CA108"><apiname>MEikSrvNotifierBase2::RegisterL()</apiname></xref>, <xref href="GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0.dita#GUID-DE445C4B-22EF-3A1F-8A69-57CB703BFAD0/GUID-5DC8D35F-FFA5-3CE8-A06D-303A7E3ECC9B"><apiname>MEikSrvNotifierBase2::StartL()</apiname></xref> and <xref href="GUID-DC21E927-18B3-3BBF-9B67-496F2D158B03.dita#GUID-DC21E927-18B3-3BBF-9B67-496F2D158B03/GUID-6AFDB981-BBA2-3A5E-A7A5-BA6B39BC4CE9"><apiname>CEikDialog::OkToExitL()</apiname></xref>. </p><p>The value KLbsExtLocationRequestNotifyUid as defined in lbsextprivacynotifiers.h |
194 must be used for the notifier registration. The choice of notifier priority |
194 must be used for the notifier registration. The choice of notifier priority |
195 is a licensee decision, but a high priority is recommended because a location |
195 is a licensee decision, but a high priority is recommended because a location |