/*
* Copyright (c) 2003 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:  SAP settings protection level handler.
*
*/

#ifndef __IMPSSAPPROTECTIONHANDLER_H
#define __IMPSSAPPROTECTIONHANDLER_H

//  INCLUDES
#include <e32base.h>
#include "impssapsettings.h"



// ENUMERATIONS
enum TIMPSSAPOperation
    {
    EOperationSetSAPName = KIMPSSAPProtectionNULLOperation + 1,
    EOperationSetSAPAddress,
    EOperationSetSAPPort,
    EOperationSetSAPUserId,
    EOperationSetSAPUserPassword,
    EOperationSetHTTPProxyAddress,
    EOperationSetHTTPProxyPort,
    EOperationSetHTTPProxyUserId,
    EOperationSetHTTPProxyUserPassword,
    EOperationSetAP,
    EOperationSetClientId,
    EOperationSetServerAuthenticationName,
    EOperationSetServerAuthenticationPassword,
    EOperationSetServerAcceptedContentType,
    EOperationDeleteSAP,
    EOperationSetProtection,
    EOperationSetHighLevelServices,
    EOperationSetAuthorizationMode
    };


// CLASS DECLARATION
/**
 *SAP protection handler.
 *
 * @lib IMPSSAPSettingsStore.dll
 * @since 3.0
 */
NONSHARABLE_CLASS( IMPSSAPProtectionHandler )
    {
public: // new functions

    /**
     * Validates is the requested operation allowd on
     * given protection level.
     *
     * @param aProtection The used protection level.
     * @param aRequestedOperation The requested operation.
     * @return KErrNone if operation is allowed. If operation
     * isn't allowed returns KErrAccessDenied.
     *
     * @since 3.0
     */
    static TInt ValidateOperation( TIMPSSAPProtection aProtection,
                                   TInt aRequestedOperation );

    /**
     * Validates is the requested operation allowd on
     * given protection level. Returns if operation is allowed.
     * If operation isn't allowed leaves with KErrAccessDenied.
     *
     * @param aProtection The used protection level.
     * @param aRequestedOperation The requested operation.
     *
     * @since 3.0
     */
    static void ValidateOperationL( TIMPSSAPProtection aProtection,
                                    TInt aRequestedOperation );

    /**
     * Checks is passed integer OK protection level.
     * See TIMPSSAPProtection enumeration for currently
     * supported protection levels.
     *
     * Leaves with KErrArgument if protection level
     * isn't supported.
     * @param aProtectionEnumeration The protection level
     * enumeration to chechk.
     *
     * @since 3.0
     */
    static void ChechkIsProperProtectionLevelL( TInt32 aProtectionEnumeration );

private:  // protection level helpers

    /**
     * Checks if the requested operation is allowed on the
     * "Brand Protection" mode. All other operations are
     * allowed except following prohibited operations:
     *  - setting SAP name
     *  - setting SAP address
     *  - deleting SAP
     * @param aRequestedOperation Requested operation to chechk.
     *        One of enumerations from TIMPSSAPOperation.
     * @return ETrue if operation is allowed, else EFalse.
     */
    static TInt IsAllowedBrandProtectionOperation( TInt aRequestedOperation );

    };

#endif      // __IMPSSAPPROTECTIONHANDLER_H

//  End of File