/*
* Copyright (c) 2006 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: 
*       Static functions for validating account settings prior to connection
*
*/



#ifndef __MSVCONNECTIONVALIDATION_H__
#define __MSVCONNECTIONVALIDATION_H__

#include <msvapi.h>
#include <eikdialg.h>
#include <iapprefs.h>
#include <ImumInternalApi.h>

#include "Imas.hrh"     // For KImasPasswordLength, KImasImailServiceNameLength
#include "ComDbUtl.h"

// CONSTANTS
enum TIMASPasswordSave
    {
    EIMASPasswordNoSave = 0,
    EIMASPasswordTempSave,
    EIMASPasswordPermanentSave,
    EIMASPasswordCancelSave // User cancelled username/password query
    };

// FORWARD DECLEARATIONS

class CMsvCommDbUtilities;
class CImBaseEmailSettings;
class MMsvProgressReporter;

class TMsvLoginData
    {
public:
    TBuf8<KImasLoginLength> iUsername;
    TBuf8<KImasPasswordLength> iPassword;
    TBool iIsPasswordTemporary;
    };

/**
* MsvConnectionValidation
*
* Static functions for validating account settings prior to connection.
*/
class MsvConnectionValidation
    {
    public:

        /**
        * Queries the login information and stores them to settings
        * @since S60 3.0
        */
        static TIMASPasswordSave RunAndHandleLoginDialogL(
            TDes8& aUserName,
            TDes8& aPassword,
            TBool& aPasswordTemporary );

        /**
        * Check that there is a password specified for aRcvServiceId, and if not, set 'aNoPassword',
        * prompt user to enter one, and store it in the settings. Returns EFalse if user cancels.
        * @param aMailboxApi: Mailbox api
        * @param aServiceId: service id to be connected
        * @param aLoginData: Username and password
        * @param aLoginRetryCounter: incremented by 1 if login dialog is displayed
        */
        static TBool CheckAndPromptForPasswordL(
            CImumInternalApi& aMailboxApi,
            TMsvId aServiceId,
            TMsvLoginData aLoginData,
            TInt& aLoginRetryCounter );


        /**
        * Prompt the user to check the login details for aRcvServiceId, allowing them to change the
        * details. Returns EFalse if user cancels.
        */
        static TBool ShowLoginDetailsRejectionDlgL(
            CImumInternalApi& aMailboxApi, 
            TMsvId aRcvServiceId);

        /**
        * Check that the IAP specified for aSendServiceId is valid
        * If current iap is not valid removes all the iaps from the service and returns EFalse.
        * @return ETrue if services iap found from commdb, EFalse if not.
        */
        static TBool CheckForIapL(
            CMsvSession& aSession,
            TMsvId aServiceId );

        /**
        * Get the name of the service with Id aServiceId.
        */
        static void GetServiceNameL(CMsvSession& aSession, TMsvId aServiceId, TDes& aServiceName);

        /**
        * Get the name of the IAP in use for the aMtmId.
        */
        static void GetServiceIapNameL(CImumInSettingsData& aAccountSettings,
            TUid aMtmUid, TDes& aIapName);

    private:

        /**
        *
        */
        static CImBaseEmailSettings* InstantiateSettingsObjectLC(const TMsvEntry& aEntry, TUid& aMtmType);

        /**
        *
        */
        static TInt RunUsernameAndPasswordDialogL( TDes& aUserName, TDes& aPassword );

        /**
        *
        * @since S60 3.0
        */
        static TBool IsAlwaysAskSet(
            const CImIAPPreferences& iapPref );
    };



#endif // __MSVCONNECTIONVALIDATION_H__