Mercurial Mercurial > oss > MCL > sf > mw > phonesrv / annotate
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.
phonesrv_plat/converged_call_engine_api/inc/mcceforwardinterface.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 31 Aug 2010 15:45:17 +0300
branchRCL_3
changeset 19 7d48bed6ce0c
parent 0 ff3b6d0fd310
child 20 987c9837762f
permissions -rw-r--r--
Revision: 201033 Kit: 201035
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     1
 
/*
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     2
 
* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     3
 
* All rights reserved.
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     4
 
* This component and the accompanying materials are made available
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     5
 
* under the terms of "Eclipse Public License v1.0"
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     6
 
* which accompanies this distribution, and is available
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     7
 
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     8
 
*
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
     9
 
* Initial Contributors:
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    10
 
* Nokia Corporation - initial contribution.
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    11
 
*
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    12
 
* Contributors:
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    13
 
*
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    14
 
* Description:  CCE call forward interface
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    15
 
*
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    16
 
*/
ff3b6d0fd310 Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff changeset 
    17
 












ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    18














ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    19


#ifndef MCCEFORWARDINTERFACE_H













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    20


#define MCCEFORWARDINTERFACE_H













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    21














ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    22


//  INCLUDES













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    23


#include <e32base.h>













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    24


#include <badesca.h> // CDesC8Array













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    25














ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    26


/**













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    27


* Call forward methods.













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    28


* MCCECallObserver is used for errors, statuses, notifications etc













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    29


*













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    30


*  @since S60 3.2













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    31


*/













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    32


class MCCEForwardInterface








19






7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    33


    {








0






ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    34


 protected: // Constructors and destructor













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    35














ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    36


    /** 













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    37


    * Protected destructor. Object cannot be deleted from client.













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    38


    * @since S60 3.2













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    39


    */













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    40


    virtual ~MCCEForwardInterface() {};








19






7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    41


    








0






ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    42


 public:








19






7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    43


    /**













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    44


    * Returns reference to array containing addresses of forward address choices.













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    45


    * Index starts from zero.













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    46


    * @since Series 60 3.2













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    47


    * @param none













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    48


    * @return array containing forward address choices








0






ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    49


    * @leave KErrNotReady Call is not in forwarding state













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    50


    * @leave KErrNotSupported If call is not mobile originated













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    51


    * @leave system error code 













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    52


    * @pre Call state is MCCECallObserver::ECCEStateForwarding and call type is MO













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    53


    * @pre Call MCCECallObserver::EVoIPEventMultipleChoices event is received








19






7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    54


    */













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    55


    virtual const CDesC8Array& GetForwardAddressChoicesL() = 0;








0






ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    56









19






7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    57


    /**













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    58


    * Forward call to selected address at given index in array received from GetForwardAddressChoicesL













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    59


    * @since Series 60 3.2













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    60


    * @param aIndex index in the address where the call is to be forwarded. 













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    61


    * Index starts from zero.













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    62


    * @return none 













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    63


    * @leave KErrArgument Index is not in array








0






ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    64


    * @leave KErrNotReady Call is not in forwarding state













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    65


    * @leave KErrNotSupported If call is not mobile originated













ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    66


    * @pre Call state is MCCECallObserver::ECCEStateForwarding and call type is MO








19






7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    67


    */













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    68


    virtual void ForwardToAddressL( const TInt aIndex ) = 0;













7d48bed6ce0c
Revision: 201033



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 
0

diff
changeset




    69


    };








0






ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    70














ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    71














ff3b6d0fd310
Revision: 201003



Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>


parents: 

diff
changeset




    72


#endif // MCCEFORWARDINTERFACE_H















MCL/sf/mw/phonesrv