diff -r 2fe1408b6811 -r e1b950c65cb4 epoc32/include/sipmanagedprofileregistry.h --- a/epoc32/include/sipmanagedprofileregistry.h Tue Mar 16 16:12:26 2010 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,131 +0,0 @@ -/* -* Copyright (c) 2003-2009 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members -* which accompanies this distribution, and is available -* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". -* -* Initial Contributors: -* Nokia Corporation - initial contribution. -* -* Contributors: -* -* Description: -* Name : sipmanagedprofileregistry.h -* Part of : SIP Profile Client -* Interface : SDK API, SIP Profile API -* The class for managing SIP profiles -* Version : 1.0 -* -*/ - - - -#ifndef CSIPMANAGEDPROFILEREGISTRY_H -#define CSIPMANAGEDPROFILEREGISTRY_H - -// INCLUDES -#include -#include -#include "sipprofileregistrybase.h" - -// FORWARD DECLARATIONS -class CSIPProfile; -class CSIPManagedProfile; -class MSIPProfileRegistryObserver; - - -// CLASS DECLARATION -/** -* @publishedAll -* @released -* -* The class for managing SIP profiles. -* This class provides the functions for -* adding/updating/removing profiles. -* -* @lib sipprofilecli.lib -*/ -class CSIPManagedProfileRegistry: public CSIPProfileRegistryBase - { - public: // Constructors and destructor - /** - * Two-phased constructor. - * @param aObserver a observer for SIP profile change events. - */ - IMPORT_C static CSIPManagedProfileRegistry* NewL( - MSIPProfileRegistryObserver& aObserver); - - /** - * Two-phased constructor. - * Constructs an object and adds the pointer to the cleanup stack; - * @param aObserver a observer for SIP profile change events. - */ - IMPORT_C static CSIPManagedProfileRegistry* NewLC( - MSIPProfileRegistryObserver& aObserver); - - /** - * Destructor - */ - IMPORT_C ~CSIPManagedProfileRegistry(); - public: //new functions - - /** - * Instantiates new profile with default values - * for given type. - * @param aType a SIP profile type to be created - * @return pre-filled instance of given type profile type; - * the ownership is transferred - */ - IMPORT_C CSIPManagedProfile* CreateL(const TSIPProfileTypeInfo& aType); - - /** - * Checks if profile is not used by other applications. - * If no other application is using the profile, profile - * can be updated. - * @param aSIPProfile a SIP profile - * @return ETrue if available for update, EFalse otherwise - * @capability ReadUserData - */ - IMPORT_C TBool IsInUseL(const CSIPProfile& aSIPProfile) const; - - /** - * Saves new profile or changes to a profile to the persistent storage. - * This function must be called after desired values are set or updated - * in the SIP profile. - * If the profile is marked for auto-registration and the profile is - * updated the profile will be re-registered. - * Function leaves on failure. - * @pre IsInUse(aSIPProfile)==EFalse - * @param aSIPProfile a sip profile to save - * @capability WriteDeviceData - * @capability NetworkServices - */ - IMPORT_C void SaveL(CSIPProfile& aSIPProfile); - - /** - * Removes and deletes SIP profile from the persistent storage. - * Function leaves on failure. - * If the profile is registered it will be de-registered before the - * removal from the persistent storage. - * @param aSIPProfile a sip profile to delete - * @capability WriteDeviceData - * @capability NetworkServices - */ - IMPORT_C void DestroyL(CSIPProfile& aSIPProfile); - - private: - - CSIPManagedProfileRegistry(MSIPProfileRegistryObserver& aObserver); - - void ConstructL(); - - /** - * Creates a new instance of type CSIPManagedProfile - * @return new instance - */ - CSIPProfile* NewInstanceL(); - }; - -#endif // CSIPMANAGEDPROFILEREGISTRY_H