--- a/Symbian3/PDK/Source/GUID-FDD3B60E-EC8B-53EF-9091-B8E7090A2F28.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-FDD3B60E-EC8B-53EF-9091-B8E7090A2F28.dita Tue Mar 30 11:56:28 2010 +0100
@@ -9,7 +9,38 @@
-->
<!DOCTYPE task
PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
-<task xml:lang="en" id="GUID-FDD3B60E-EC8B-53EF-9091-B8E7090A2F28"><title>Phone Lock Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the phone locks using the <apiname>RMobilePhone</apiname> functions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <steps id="GUID-5A879807-E513-5019-9760-999874756FA0"> <step id="GUID-D8C4A67B-460D-565F-B164-26FCFA209FF1"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::GetLockInfo()</apiname></xref> to get the current phone lock setting. </cmd> <info>The lock is specified by a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneLock</apiname></xref> flag. </info> </step> <step id="GUID-C894535A-5107-5792-B169-5ED60B936E9B"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyLockInfoChange()</apiname></xref> to get the notification of any changes in lock settings. </cmd> </step> <step id="GUID-DD7FF1FA-06AD-514F-A6CC-681303D8FE5C"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetLockSetting()</apiname></xref> to set a phone lock. </cmd> </step> </steps> <result><p>Information about a lock status whether the lock is on or off, and the setting lock enabled or disabled is encapsulated in an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneLockInfoV1</apiname></xref> object. An enabled lock setting means that the lock is active and can be locked or unlocked if the user enters the security code. If the lock is enabled, it returns to the locked state if certain event such as the phone power down occurs. </p> </result> <example><title>Phone lock example</title> <p>The following code checks if phone lock information can be accessed and get that information. The example code also checks if the phone lock is enabled. </p> <p>The code assumes <codeph>iMobilePhone</codeph> is an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> object. </p> <codeblock id="GUID-90C41708-576E-5F8E-A809-B056C76E2060" xml:space="preserve">TUint32 securityCaps;
+<task id="GUID-FDD3B60E-EC8B-53EF-9091-B8E7090A2F28" xml:lang="en"><title>Phone
+Lock Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the phone locks using
+the <codeph>RMobilePhone</codeph> functions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
+
+
+<steps id="GUID-5A879807-E513-5019-9760-999874756FA0">
+
+
+
+
+<step id="GUID-D8C4A67B-460D-565F-B164-26FCFA209FF1"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::GetLockInfo()</apiname></xref> to
+get the current phone lock setting. </cmd>
+
+<info>The lock is specified by a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneLock</apiname></xref> flag. </info>
+</step>
+<step id="GUID-C894535A-5107-5792-B169-5ED60B936E9B"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyLockInfoChange()</apiname></xref> to
+get the notification of any changes in lock settings. </cmd>
+</step>
+<step id="GUID-DD7FF1FA-06AD-514F-A6CC-681303D8FE5C"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetLockSetting()</apiname></xref> to
+set a phone lock. </cmd>
+</step>
+</steps>
+<result id="GUID-1D9BE379-4C22-4923-A270-2F975EA2C3B1"><p>Information about a lock status whether the lock is on or off,
+and the setting lock enabled or disabled is encapsulated in an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneLockInfoV1</apiname></xref> object.
+An enabled lock setting means that the lock is active and can be locked or
+unlocked if the user enters the security code. If the lock is enabled, it
+returns to the locked state if certain event such as the phone power down
+occurs. </p> </result>
+<example><title>Phone lock example</title> <p>The following code checks if
+phone lock information can be accessed and get that information. The example
+code also checks if the phone lock is enabled. </p> <p>The code assumes <codeph>iMobilePhone</codeph> is
+an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> object. </p> <codeblock id="GUID-90C41708-576E-5F8E-A809-B056C76E2060" xml:space="preserve">TUint32 securityCaps;
User::LeaveIfError(iMobilePhone.GetSecurityCaps(securityCaps));
if (securityCaps & RMobilePhone::KCapsLockPhone)
@@ -29,4 +60,5 @@
{
//do something
}
-</codeblock> </example> </taskbody></task>
\ No newline at end of file
+</codeblock> </example>
+</taskbody></task>
\ No newline at end of file