<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-FE6A63E5-71F9-5F60-A641-7FBD2D4DDC59" xml:lang="en"><title>Phone

Locks and Security Tutorial</title><shortdesc>This tutorial describes how to use the phone lock and security

features in a Symbian platform device using the <codeph>RMobilePhone</codeph> functions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-BB63AE23-80F0-44B8-BC6A-C4C4DA4E0B7D"><title>Introduction</title> <p>The <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> fucntions allows clients to: </p> <ul>

<li id="GUID-876B901F-A59B-5A39-B7E4-D19F8CE74792"><p>get the security and

lock capabilities of the phone </p> </li>

<li id="GUID-63CDF1B1-6AB6-57E8-BE36-90F10DF1C10B"><p>get the status of phone

locks </p> </li>

<li id="GUID-CE693A16-0F03-50F4-8564-E97EA4448757"><p>be notified of security

events </p> </li>

<li id="GUID-8D708F4E-31A4-556E-8761-07A607A69DBE"><p>enter and change security

codes </p> </li>

<li id="GUID-F2A37255-21E4-5596-9C36-1405B773B9C1"><p>change the setting of

a lock </p> </li>

</ul> </section>

<section id="GUID-E3F40EBB-3977-4837-9FC9-D2F10EEDBD1D"><title>Capabilities</title> <p>The

supported locks can be different in different modes: </p> <ul>

<li id="GUID-0198685A-F977-558E-83D2-406C5130B265"><p>in GSM, there are two

locks associated with the SIM application, that is PIN1 and PIN2. The PIN1

can be enabled or disabled </p> </li>

<li id="GUID-C431CC3F-4407-561A-908A-46B7D5D4A145"><p>in CDMA, a R-UIM (ICC

card) has a PIN1 lock, but not all CDMA phones have a R-UIM. A Number Assignment

Module lock is specific to CDMA networks. </p> </li>

<li id="GUID-BDB8F057-628D-5F13-96C0-21492A63EDE1"><p>in a multimode phone,

the phone determines its ICC access policy. For example whether a GSM SIM

can be accessed while the phone is in a CDMA mode. </p> </li>

</ul><p>To dynamically get the lock and security capabilities from the TSY

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>.

 </p> </section>

<section id="GUID-6D5A298A-8E73-49FF-8CC5-1BA1D7303B23"><title>Results</title> <p>The function must return a bitmask of an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneSecurityCaps</apiname></xref> flag </p> </section>

<section id="GUID-0A01AAFB-2C28-4167-824D-C859545568A3"><p> <xref href="GUID-FDD3B60E-EC8B-53EF-9091-B8E7090A2F28.dita">Phone

Lock Settings Tutorial</xref>  </p> <p> <xref href="GUID-0703C141-17C7-5918-9CF3-EF6CD408975B.dita">Phone

Security Code Tutorial</xref>  </p> </section>

</conbody></concept>