diff -r 000000000000 -r ff3b6d0fd310 phonesrv_plat/call_remote_party_information_api/inc/ccallremotepartyinformation.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phonesrv_plat/call_remote_party_information_api/inc/ccallremotepartyinformation.h Tue Feb 02 01:11:09 2010 +0200 @@ -0,0 +1,95 @@ +/* +* Copyright (c) 2009-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "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: +* +* Description: Remote party information +* +*/ + +#ifndef CCALLREMOTEPARTYINFORMATION_H +#define CCALLREMOTEPARTYINFORMATION_H + +#include + +class CCallRemotePartyInformationImpl; +class MCallRemotePartyInfo; +class MCallRemotePartyInformationObserver; +class CCallRemotePartyInfoIter; + +/** + * + */ +NONSHARABLE_CLASS( CCallRemotePartyInformation ) : public CBase + { + +public: + + /** + * Two-phased constructor. + */ + IMPORT_C static CCallRemotePartyInformation* NewL(); + + + /** + * Destructor. + */ + virtual ~CCallRemotePartyInformation(); + + /** + * Allows a client to be notified when there are changes in + * remote party information. There can be only one observer + * per CCallRemotePartyInformation instance. + * + * @since S60 v5.2 + * @param aObserver Observer for notifications. + */ + IMPORT_C void NotifyChanges( MCallRemotePartyInformationObserver& aObserver ); + + /** + * Used to cancel previously placed NotifyCallInformationChanges call. + * + * @since S60 v5.2 + */ + IMPORT_C void CancelNotification(); + + /** + * Gets the snapshot of remote party information of ongoing calls. + * + * @since S60 v5.2 + * @return Remote party info of ongoing calls. + */ + IMPORT_C CCallRemotePartyInfoIter& GetRemotePartyInformationL( ); + + /** + * Gets the remote party information of a call. + * + * @since S60 v5.2 + * @param aCallIndex Specifies a call. + * @return Remote party information. NULL if the remote party information + * is not available for call. Ownership not given. + */ + IMPORT_C const MCallRemotePartyInfo* GetRemotePartyInformationL( TInt aCallIndex ); + +private: + + CCallRemotePartyInformation(); + + void ConstructL(); + + +private: // data + + CCallRemotePartyInformationImpl* iImpl; + + }; + +#endif // CCALLREMOTEPARTYINFORMATION_H