<?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-512B6FEB-3328-59A6-913C-7E9F7A5A0A04" xml:lang="en"><title>Retrieve
Message Waiting Information Tutorial</title><shortdesc>This tutorial describes how to retrieve a message waiting information. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context><p>Message waiting indicator informs the subscriber that, depending
on the mode, the voice messages, data messages, fax messages, and email messages
are waiting to be retrieved. </p> </context>
<steps id="GUID-BB069FC3-27FB-5EA8-8C40-7C1C00B3E6D9">
<step id="GUID-D6D4D339-EFD9-540B-BBF7-793F3C14030A"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-28B0955C-73B4-39B1-B0BB-2A8788795936"><apiname>RMobilePhone::NotifyMessageWaiting()</apiname></xref> to
get the notification when the phone receives a message waiting indication
from the network. </cmd>

<info>In GSM and WCDMA modes, message waiting indications are received through
SMS messages. This is applicable only to CDMA. </info>
</step>
<step id="GUID-E5A12E6D-6571-590C-AA75-7009201102FF"><cmd>Retrieve the set
of message waiting indicators from the current ICC using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-938BA677-F8E8-322D-B5C0-73FD3ADFCF76"><apiname>RMobilePhone::GetIccMessageWaitingIndicators()</apiname></xref>. </cmd>
<info>Indicator values are described by <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-10B245E9-5283-3C57-B7ED-62CAD938D44D"><apiname>RMobilePhone::TMobilePhoneMessageWaitingV1</apiname></xref>. </info>
</step>
<step id="GUID-709B003B-8F08-5A24-B9C1-04137C524003"><cmd>Set the message
waiting indicators on the current ICC using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-B53A9F88-DC7B-3051-86F1-5539409A1E99"><apiname>RMobilePhone::SetIccMessageWaitingIndicators()</apiname></xref>. </cmd>
</step>
<step id="GUID-9A1A9A01-0DFA-531F-9088-ACE1E4230F11"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-D11F9FAF-5F0B-3055-AF77-8299E29CF088"><apiname>RMobilePhone::NotifyIccMessageWaitingIndicatorsChange()</apiname></xref> to
get the notifications of any changes to the message waiting indicators on
the current ICC. </cmd>
</step>
</steps>
<example><title>Message waiting indicator example</title> <p>The following
code gets the message waiting indicators and returns the number of voice messages
waiting. </p> <codeblock id="GUID-35C73A9E-4502-5B0D-8A3A-19E93FFEA43E" xml:space="preserve">TUint8 CClientApp::VoiceMessagesWaitingL()
    {
    RMobilePhone::TMobilePhoneMessageWaitingV1 messageWaiting;
    RMobilePhone::TMobilePhoneMessageWaitingV1Pckg messageWaitingPckg(messageWaiting);
    TRequestStatus status;

    iMobilePhone.GetIccMessageWaitingIndicators(status,messageWaitingPckg);
    User::WaitForRequest(status);
    User::LeaveIfError(status.Int());

    return messageWaiting.iVoiceMsgs;
    }
</codeblock> </example>
</taskbody></task>