--- a/Symbian3/PDK/Source/GUID-C328D060-62A9-5425-B33A-704E5FC18290.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-C328D060-62A9-5425-B33A-704E5FC18290.dita Tue Mar 30 11:56:28 2010 +0100
@@ -1,50 +1,78 @@
-<?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 xml:lang="en" id="GUID-C328D060-62A9-5425-B33A-704E5FC18290"><title>Call Waiting Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the call waiting settings in a Symbian OS device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <steps-unordered> <step id="GUID-A978B2DF-12FD-5047-87D2-A1BA087111E3"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CRetrieveMobilePhoneCWList</apiname></xref> to get a list of call waiting entries in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CMobilePhoneCWList</apiname></xref> object. </cmd> <info>A list that indicates different waiting status for different service groups such as voice, fax, data and auxiliary voice is required. Each entry in the list is a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCWInfoEntryV1</apiname></xref> object, recording the service group and call waiting status. </info> </step> <step id="GUID-474DFCA5-ABAD-5367-9030-0B1E78516DED"><cmd>Set the status of the call waiting service using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetCallWaitingStatus()</apiname></xref>. </cmd> <info>The action taken is described in <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneServiceAction</apiname></xref>. This is possible only in the CDMA mode if the feature code strings are programmed for the call forwarding service, see <xref href="GUID-EE8660B7-DAC2-5A57-BDEA-418900BAE421.dita">Call Supplementary Services Tutorial</xref> for more information </info> </step> <step id="GUID-B6555A38-7061-5D95-9E20-B98CBC09A044"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyCallWaitingStatusChange()</apiname></xref> to get the notification of any changes in the status of the call waiting service. </cmd> </step> </steps-unordered> <example><title>Call waiting settings example</title> <p>The following code gets the list of call waiting entries, and prints each service group for which call waiting is active. 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-920D3E9E-CBE3-5075-A262-CA73D331E00B" xml:space="preserve">void CClientApp::CallWaitingL()
- {
-
- // Create and start CW retriever
- CRetrieveMobilePhoneCWList* retrieveCWList = CRetrieveMobilePhoneCWList::NewL(iMobilePhone);
- CleanupStack::PushL(retrieveCWList);
-
- TRequestStatus status;
- retrieveCWList->Start(status);
- User::WaitForRequest(status);
- User::LeaveIfError(status.Int());
-
- // Get the list of call waiting entries
- CMobilePhoneCWList* cwList = retrieveCWList->RetrieveListL();
- CleanupStack::PushL(cwList);
-
- // Print each service group for which CW is active
- TInt nEntries = cwList->Enumerate();
- RMobilePhone::TMobilePhoneCWInfoEntryV1 cwEntry;
-
- // Names of service groups
- 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<=nEntries; i++)
- {
- cwEntry = cwList->GetEntryL(i);
- if (cwEntry.iStatus == RMobilePhone::ECallWaitingStatusActive)
- {
- aServiceGroupName = aServiceGroupNameStings[cwEntry.iServiceGroup];
- console->Printf(_L("Call waiting active for service group %d\n"),aServiceGroupName);
- }
- }
-
- // Clean up
- CleanupStack::PopAndDestroy(2); // cwList, retrieveCWList
-
- }</codeblock> </example> </taskbody></task>
\ No newline at end of file
+<?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-C328D060-62A9-5425-B33A-704E5FC18290" xml:lang="en"><title>Call
+Waiting Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the call waiting settings
+in a Symbian platform device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<steps-unordered>
+<step id="GUID-A978B2DF-12FD-5047-87D2-A1BA087111E3"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CRetrieveMobilePhoneCWList</apiname></xref> to
+get a list of call waiting entries in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>CMobilePhoneCWList</apiname></xref> object. </cmd>
+
+<info>A list that indicates different waiting status for different service
+groups such as voice, fax, data and auxiliary voice is required. Each entry
+in the list is a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCWInfoEntryV1</apiname></xref> object,
+recording the service group and call waiting status. </info>
+</step>
+<step id="GUID-474DFCA5-ABAD-5367-9030-0B1E78516DED"><cmd>Set the status of
+the call waiting service using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetCallWaitingStatus()</apiname></xref>. </cmd>
+
+<info>The action taken is described in <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneServiceAction</apiname></xref>.
+This is possible only in the CDMA mode if the feature code strings are programmed
+for the call forwarding service, see <xref href="GUID-EE8660B7-DAC2-5A57-BDEA-418900BAE421.dita">Call
+Supplementary Services Tutorial</xref> for more information </info>
+</step>
+<step id="GUID-B6555A38-7061-5D95-9E20-B98CBC09A044"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyCallWaitingStatusChange()</apiname></xref> to get the notification of any changes in the status of the call waiting
+service. </cmd>
+</step>
+</steps-unordered>
+<example><title>Call waiting settings example</title> <p>The following code
+gets the list of call waiting entries, and prints each service group for which
+call waiting is active. 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-920D3E9E-CBE3-5075-A262-CA73D331E00B" xml:space="preserve">void CClientApp::CallWaitingL()
+ {
+
+ // Create and start CW retriever
+ CRetrieveMobilePhoneCWList* retrieveCWList = CRetrieveMobilePhoneCWList::NewL(iMobilePhone);
+ CleanupStack::PushL(retrieveCWList);
+
+ TRequestStatus status;
+ retrieveCWList->Start(status);
+ User::WaitForRequest(status);
+ User::LeaveIfError(status.Int());
+
+ // Get the list of call waiting entries
+ CMobilePhoneCWList* cwList = retrieveCWList->RetrieveListL();
+ CleanupStack::PushL(cwList);
+
+ // Print each service group for which CW is active
+ TInt nEntries = cwList->Enumerate();
+ RMobilePhone::TMobilePhoneCWInfoEntryV1 cwEntry;
+
+ // Names of service groups
+ 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<=nEntries; i++)
+ {
+ cwEntry = cwList->GetEntryL(i);
+ if (cwEntry.iStatus == RMobilePhone::ECallWaitingStatusActive)
+ {
+ aServiceGroupName = aServiceGroupNameStings[cwEntry.iServiceGroup];
+ console->Printf(_L("Call waiting active for service group %d\n"),aServiceGroupName);
+ }
+ }
+
+ // Clean up
+ CleanupStack::PopAndDestroy(2); // cwList, retrieveCWList
+
+ }</codeblock> </example>
+</taskbody></task>
\ No newline at end of file