|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-FE6A63E5-71F9-5F60-A641-7FBD2D4DDC59" xml:lang="en"><title>Phone |
|
13 Locks and Security Tutorial</title><shortdesc>This tutorial describes how to use the phone lock and security |
|
14 features in a Symbian OS device using the <apiname>RMobilePhone</apiname> functions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 |
|
16 <section><title>Introduction</title> <p>The <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> fucntions |
|
17 allows clients to: </p> <ul> |
|
18 <li id="GUID-876B901F-A59B-5A39-B7E4-D19F8CE74792"><p>get the security and |
|
19 lock capabilities of the phone </p> </li> |
|
20 <li id="GUID-63CDF1B1-6AB6-57E8-BE36-90F10DF1C10B"><p>get the status of phone |
|
21 locks </p> </li> |
|
22 <li id="GUID-CE693A16-0F03-50F4-8564-E97EA4448757"><p>be notified of security |
|
23 events </p> </li> |
|
24 <li id="GUID-8D708F4E-31A4-556E-8761-07A607A69DBE"><p>enter and change security |
|
25 codes </p> </li> |
|
26 <li id="GUID-F2A37255-21E4-5596-9C36-1405B773B9C1"><p>change the setting of |
|
27 a lock </p> </li> |
|
28 </ul> </section> |
|
29 <section><title>Capabilities</title> <p>The supported locks can be different |
|
30 in different modes: </p> <ul> |
|
31 <li id="GUID-0198685A-F977-558E-83D2-406C5130B265"><p>in GSM, there are two |
|
32 locks associated with the SIM application, that is PIN1 and PIN2. The PIN1 |
|
33 can be enabled or disabled </p> </li> |
|
34 <li id="GUID-C431CC3F-4407-561A-908A-46B7D5D4A145"><p>in CDMA, a R-UIM (ICC |
|
35 card) has a PIN1 lock, but not all CDMA phones have a R-UIM. A Number Assignment |
|
36 Module lock is specific to CDMA networks. </p> </li> |
|
37 <li id="GUID-BDB8F057-628D-5F13-96C0-21492A63EDE1"><p>in a multimode phone, |
|
38 the phone determines its ICC access policy. For example whether a GSM SIM |
|
39 can be accessed while the phone is in a CDMA mode. </p> </li> |
|
40 </ul><p>To dynamically get the lock and security capabilities from the TSY |
|
41 for the current mode, call <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-6E3C3933-458A-3FFD-9C0B-2D1E53F0E1BB"><apiname>RMobilePhone::GetSecurityCaps()</apiname></xref>. |
|
42 </p> </section> |
|
43 <section><title>Results</title> <p>The |
|
44 function must return a bitmask of an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneSecurityCaps</apiname></xref> flag </p> </section> |
|
45 |
|
46 <section><p> <xref href="GUID-FDD3B60E-EC8B-53EF-9091-B8E7090A2F28.dita">Phone |
|
47 Lock Settings Tutorial</xref> </p> <p> <xref href="GUID-0703C141-17C7-5918-9CF3-EF6CD408975B.dita">Phone |
|
48 Security Code Tutorial</xref> </p> </section> |
|
49 </conbody></concept> |