Mercurial Mercurial > oss > FCL > sftools > depl > docscontent / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Symbian3/PDK/Source/GUID-79D19798-FC6B-53D5-B99C-A079F74CE540.dita
changeset 14 578be2adaf3e
parent 5 f345bda72bc4 
--- a/Symbian3/PDK/Source/GUID-79D19798-FC6B-53D5-B99C-A079F74CE540.dita	Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-79D19798-FC6B-53D5-B99C-A079F74CE540.dita	Fri Aug 13 16:47:46 2010 +0100
@@ -1,83 +1,83 @@
-<?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 task
-  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
-<task id="GUID-79D19798-FC6B-53D5-B99C-A079F74CE540" xml:lang="en"><title> Call
-Barring Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the call barring settings
-in a Symbian platform device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
-<context id="GUID-906BDC08-CA36-4A6F-9FE9-B9450E8A4688"><p>The Call Barring supplementary service of the GSM
-prevents the subscriber from making or receiving certain types of call. CDMA
-does not have this service, though phone manufacturers can prevent certain
-call types by using internal settings.  </p></context>
-<steps-unordered>
-<step id="GUID-0F44B07D-9B51-5386-8B7A-A2280BF50538"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CRetrieveMobilePhoneCBList</apiname></xref> to
-get a list in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CMobilePhoneCBList</apiname></xref> object
-of call barring entries for one or more call barring conditions. </cmd>
-<info>For example the condition can be barring of incoming calls. Conditions
-are enumerated in <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCBCondition</apiname></xref>. </info>
-<info>A list is required as there can be different barring situations for
-different service groups such as voice, fax, data and auxiliary voice. Each
-entry in the list is a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCBInfoEntryV1</apiname></xref> object,
-recording the condition, service group, and the status. </info>
-</step>
-<step id="GUID-C389E8CE-2DDD-57BB-B9F9-80DBB34441B4"><cmd>Set the status of
-the call barring services using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetCallBarringStatus()</apiname></xref>. </cmd>
-<info>The change is described in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCBChangeV1</apiname></xref> object. </info>
-</step>
-<step id="GUID-71B99CD0-CA3A-50C6-A1F4-5D7E89C9BAD1"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyCallBarringStatusChange()</apiname></xref> to get the notification of any chages to the status of a call barring service. </cmd>
-</step>
-<step id="GUID-B23F54F5-CF85-57BD-835A-660191FBF473"><cmd>Change the password
-associated with the call barring service using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetCallBarringPassword()</apiname></xref>. </cmd>
-<info>Old and new passwords are provided in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhonePasswordChangeV1</apiname></xref> object. </info>
-</step>
-</steps-unordered>
-<example><title>Call barring example</title> <p>The following code gets the
-list of call barring entries for outgoing international calls, and prints
-each service group for which call barring is active. </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-2688D7A3-FD8A-559D-8990-448CA8C252AD" xml:space="preserve">void CClientApp::CallBarringL()
-    {
-    // Create and start CB retriever for outgoing international calls
-    CRetrieveMobilePhoneCBList* retrieveCBList = CRetrieveMobilePhoneCBList::NewL(iMobilePhone);
-
-    CleanupStack::PushL(retrieveCBList);
-
-    TRequestStatus status;
-
-    retrieveCBList-&gt;Start(status, RMobilePhone::EBarOutgoingInternational);
-    User::WaitForRequest(status);
-    User::LeaveIfError(status.Int());
-
-    // Get the list of call barring entries
-    CMobilePhoneCBList* cbList = retrieveCBList-&gt;RetrieveListL();
-    CleanupStack::PushL(cbList);
-
-    // Print each service group for which CB active
-    TInt nEntries = cbList-&gt;Enumerate();
-    RMobilePhone::TMobilePhoneCBInfoEntryV1 cbEntry;
-
-    TText* aServiceGroupNameStings[]={_S("Unspecified"), _S("Voice"), _S("Auxiliary Voice"),
-        _S("CSD"),_S("Packet"),_S("Fax"),_S("SMS"),_S("All")};
-    TPtr aServiceGroupName(NULL,20);
-
-    for (TInt i=0; i&lt;=nEntries; i++)
-        {        
-         cbEntry = cbList-&gt;GetEntryL(i);
-         if (cbEntry.iStatus == RMobilePhone::ECallBarringStatusActive)
-            {
-             aServiceGroupName = aServiceGroupNameStings[cbEntry.iServiceGroup];
-             console-&gt;Printf(_L("Outgoing international barring set for %S\n"), aServiceGroupName);
-            }
-        }
-
-    // Clean up
-    CleanupStack::PopAndDestroy(2); // cbList, retrieveCBList    
-
-    }</codeblock> </example>
+<?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 task
+  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
+<task id="GUID-79D19798-FC6B-53D5-B99C-A079F74CE540" xml:lang="en"><title> Call
+Barring Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the call barring settings
+in a Symbian platform device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<context id="GUID-906BDC08-CA36-4A6F-9FE9-B9450E8A4688"><p>The Call Barring supplementary service of the GSM
+prevents the subscriber from making or receiving certain types of call. CDMA
+does not have this service, though phone manufacturers can prevent certain
+call types by using internal settings.  </p></context>
+<steps-unordered>
+<step id="GUID-0F44B07D-9B51-5386-8B7A-A2280BF50538"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CRetrieveMobilePhoneCBList</apiname></xref> to
+get a list in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CMobilePhoneCBList</apiname></xref> object
+of call barring entries for one or more call barring conditions. </cmd>
+<info>For example the condition can be barring of incoming calls. Conditions
+are enumerated in <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCBCondition</apiname></xref>. </info>
+<info>A list is required as there can be different barring situations for
+different service groups such as voice, fax, data and auxiliary voice. Each
+entry in the list is a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCBInfoEntryV1</apiname></xref> object,
+recording the condition, service group, and the status. </info>
+</step>
+<step id="GUID-C389E8CE-2DDD-57BB-B9F9-80DBB34441B4"><cmd>Set the status of
+the call barring services using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetCallBarringStatus()</apiname></xref>. </cmd>
+<info>The change is described in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCBChangeV1</apiname></xref> object. </info>
+</step>
+<step id="GUID-71B99CD0-CA3A-50C6-A1F4-5D7E89C9BAD1"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyCallBarringStatusChange()</apiname></xref> to get the notification of any chages to the status of a call barring service. </cmd>
+</step>
+<step id="GUID-B23F54F5-CF85-57BD-835A-660191FBF473"><cmd>Change the password
+associated with the call barring service using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetCallBarringPassword()</apiname></xref>. </cmd>
+<info>Old and new passwords are provided in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhonePasswordChangeV1</apiname></xref> object. </info>
+</step>
+</steps-unordered>
+<example><title>Call barring example</title> <p>The following code gets the
+list of call barring entries for outgoing international calls, and prints
+each service group for which call barring is active. </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-2688D7A3-FD8A-559D-8990-448CA8C252AD" xml:space="preserve">void CClientApp::CallBarringL()
+    {
+    // Create and start CB retriever for outgoing international calls
+    CRetrieveMobilePhoneCBList* retrieveCBList = CRetrieveMobilePhoneCBList::NewL(iMobilePhone);
+
+    CleanupStack::PushL(retrieveCBList);
+
+    TRequestStatus status;
+
+    retrieveCBList-&gt;Start(status, RMobilePhone::EBarOutgoingInternational);
+    User::WaitForRequest(status);
+    User::LeaveIfError(status.Int());
+
+    // Get the list of call barring entries
+    CMobilePhoneCBList* cbList = retrieveCBList-&gt;RetrieveListL();
+    CleanupStack::PushL(cbList);
+
+    // Print each service group for which CB active
+    TInt nEntries = cbList-&gt;Enumerate();
+    RMobilePhone::TMobilePhoneCBInfoEntryV1 cbEntry;
+
+    TText* aServiceGroupNameStings[]={_S("Unspecified"), _S("Voice"), _S("Auxiliary Voice"),
+        _S("CSD"),_S("Packet"),_S("Fax"),_S("SMS"),_S("All")};
+    TPtr aServiceGroupName(NULL,20);
+
+    for (TInt i=0; i&lt;=nEntries; i++)
+        {        
+         cbEntry = cbList-&gt;GetEntryL(i);
+         if (cbEntry.iStatus == RMobilePhone::ECallBarringStatusActive)
+            {
+             aServiceGroupName = aServiceGroupNameStings[cbEntry.iServiceGroup];
+             console-&gt;Printf(_L("Outgoing international barring set for %S\n"), aServiceGroupName);
+            }
+        }
+
+    // Clean up
+    CleanupStack::PopAndDestroy(2); // cbList, retrieveCBList    
+
+    }</codeblock> </example>
 </taskbody></task>
\ No newline at end of file
FCL/sftools/depl/docscontent