1 /*

     2 * Copyright (c) 2009-2009 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Remote party information

    15 *

    16 */

    17 

    18 #ifndef CCALLREMOTEPARTYINFORMATION_H

    19 #define CCALLREMOTEPARTYINFORMATION_H

    20 

    21 #include <e32base.h>

    22 

    23 class CCallRemotePartyInformationImpl;

    24 class MCallRemotePartyInfo;

    25 class MCallRemotePartyInformationObserver;

    26 class CCallRemotePartyInfoIter;

    27 

    28 /**

    29  * 

    30  */

    31 NONSHARABLE_CLASS( CCallRemotePartyInformation ) : public CBase

    32     {

    33 

    34 public:

    35 

    36     /**

    37      * Two-phased constructor.          

    38      */

    39     IMPORT_C static CCallRemotePartyInformation* NewL();

    40     

    41     

    42     /**

    43     * Destructor.

    44     */

    45     virtual ~CCallRemotePartyInformation();

    46     

    47     /**

    48      * Allows a client to be notified when there are changes in

    49      * remote party information. There can be only one observer

    50      * per CCallRemotePartyInformation instance.

    51      *

    52      * @since S60 v5.2 

    53      * @param aObserver Observer for notifications.

    54      */

    55     IMPORT_C void NotifyChanges( MCallRemotePartyInformationObserver& aObserver );

    56         

    57     /**

    58      * Used to cancel previously placed NotifyCallInformationChanges call.

    59      *

    60      * @since S60 v5.2      

    61      */

    62     IMPORT_C void CancelNotification();

    63     

    64     /**

    65      * Gets the snapshot of remote party information of ongoing calls.

    66      *

    67      * @since S60 v5.2      

    68      * @return Remote party info of ongoing calls.

    69      */

    70     IMPORT_C CCallRemotePartyInfoIter& GetRemotePartyInformationL( );

    71     

    72     /**

    73      * Gets the remote party information of a call.

    74      *

    75      * @since S60 v5.2  

    76      * @param aCallIndex Specifies a call.    

    77      * @return Remote party information. NULL if the remote party information

    78      * is not available for call. Ownership not given.

    79      */

    80      IMPORT_C const MCallRemotePartyInfo* GetRemotePartyInformationL( TInt aCallIndex );

    81      

    82 private:

    83 

    84     CCallRemotePartyInformation();

    85 

    86     void ConstructL();

    87 

    88 

    89 private: // data    

    90     

    91     CCallRemotePartyInformationImpl* iImpl;	

    92 	

    93     };

    94 

    95 #endif // CCALLREMOTEPARTYINFORMATION_H