epoc32/include/mw/sipmanagedprofileregistry.h
branchSymbian3
changeset 4 837f303aceeb
parent 3 e1b950c65cb4
equal deleted inserted replaced
3:e1b950c65cb4 4:837f303aceeb
     1 /*
     1 /*
     2 * Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
     2 * Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
     3 * All rights reserved.
     3 * All rights reserved.
     4 * This component and the accompanying materials are made available
     4 * This component and the accompanying materials are made available
     5 * 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
     5 * under the terms of "Eclipse Public License v1.0"
     6 * which accompanies this distribution, and is available
     6 * which accompanies this distribution, and is available
     7 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
     8 *
     8 *
     9 * Initial Contributors:
     9 * Initial Contributors:
    10 * Nokia Corporation - initial contribution.
    10 * Nokia Corporation - initial contribution.
    11 *
    11 *
    12 * Contributors:
    12 * Contributors:
    79                 * the ownership is transferred
    79                 * the ownership is transferred
    80         */
    80         */
    81         IMPORT_C CSIPManagedProfile* CreateL(const TSIPProfileTypeInfo& aType); 
    81         IMPORT_C CSIPManagedProfile* CreateL(const TSIPProfileTypeInfo& aType); 
    82 
    82 
    83         /**
    83         /**
    84         * Checks if profile is not used by other applications. 
    84         * Checks if profile is not used by other applications.
    85         * If no other application is using the profile, profile
       
    86         * can be updated.
       
    87         * @param aSIPProfile a SIP profile
    85         * @param aSIPProfile a SIP profile
    88         * @return ETrue if available for update, EFalse otherwise
    86         * @return ETrue if its being used by other applications, EFalse otherwise
    89         * @capability ReadUserData
    87         * @capability ReadUserData
    90         */
    88         */
    91         IMPORT_C TBool IsInUseL(const CSIPProfile& aSIPProfile) const; 
    89         IMPORT_C TBool IsInUseL(const CSIPProfile& aSIPProfile) const; 
    92 
    90 
    93         /**
    91         /**
    95         * This function must be called after desired values are set or updated
    93         * This function must be called after desired values are set or updated
    96         * in the SIP profile. 
    94         * in the SIP profile. 
    97         * If the profile is marked for auto-registration and the profile is 
    95         * If the profile is marked for auto-registration and the profile is 
    98         * updated the profile will be re-registered.
    96         * updated the profile will be re-registered.
    99         * Function leaves on failure.
    97         * Function leaves on failure.
   100         * @pre IsInUse(aSIPProfile)==EFalse
       
   101         * @param aSIPProfile a sip profile to save
    98         * @param aSIPProfile a sip profile to save
   102         * @capability WriteDeviceData
    99         * @capability WriteDeviceData
   103         * @capability NetworkServices
   100         * @capability NetworkServices
   104         */
   101         */
   105         IMPORT_C void SaveL(CSIPProfile& aSIPProfile);
   102         IMPORT_C void SaveL(CSIPProfile& aSIPProfile);