/*
* 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:    Container class for containing MCC SRTP crypto contexts
*
*/




#ifndef MMCCCRYPTOCONTEXTCONTAINER_H
#define MMCCCRYPTOCONTEXTCONTAINER_H

//  INCLUDES
#include <e32base.h>


// FORWARD DECLARATIONS
class TMMFMessage;
class TMccCryptoContext;
class TMccSrtpMasterKey;
class TMccSrtpMasterSalt;
class TMccSrtpCryptoParams;

/**
*  Container class for containing and handling
*  MCC crypto contexts.
*
*  @lib mmccinterface.lib
*/
NONSHARABLE_CLASS( CMccCryptoContextContainer ) : public CBase
    {
public:  // Constructors and destructor

    /**
     * Two-phased constructor.
     */
    static CMccCryptoContextContainer* NewL( );

    /**
     * Destructor.
     */
    virtual ~CMccCryptoContextContainer();

public: // New functions

    /** 
     * Creates new crypto context.
     * @since Series 60 3.2
     * @param aMasterKey The master key value.e.
     * @param aSaltKey The master salt value.
     * @param aContextId ID of the new context if successful.
     * @param aCryptoParams Crypto context optional parameters.
     * @return KErrNone if success; otherwise system wide error code.
    */
    TInt CreateContext( const TMccSrtpMasterKey& aMasterKey,
                        const TMccSrtpMasterSalt& aSaltKey,
    					TUint32& aContextId,
    				    const TMccSrtpCryptoParams& aCryptoParams );

    /**
     * Removes crypto context.
     * @since Series 60 3.2
     * @param aContextId ID of the removable context.
     * @return KErrNone if success; otherwise system wide error code.
    */
    TInt RemoveContext( TUint32 aContextId );
    
    /** 
     * Updates existing context.
     * @since Series 60 3.2
     * @param aContextId ID of the updating context.
     * @param aContext New context which updates existing context.
     * @return KErrNone if success; otherwise system wide error code.
    */
    TInt UpdateContext( TUint32 aContextId,
                        TMccCryptoContext& aContext );
    
    /**
     * Finds right context and returns it to caller.
     * @since Series 60 3.2
     * @param aContextId ID of the new context if successful.
     * @param aContext Founded context
     * @return KErrNone if success; otherwise system wide error code.
     */
    TInt GetContext( TUint32 aContextId,
                     TMccCryptoContext* &aContext );
   
private:
    
    /**
     * By default Symbian 2nd phase constructor is private.
     */
    void ConstructL();
    
    /**
     * Generates a new crypto context identifier
     * @since Series 60 3.2
     * @return TUint32  New crypto context id;
     */
    TUint32 GenerateContextId();
    
    /**
     * Finds given crypto context from context array.
     * @since Series 60 3.2
     * @param aContextId Crypto context ID
     * @return Index to context array or KErrNotFound.
     */
    TInt FindContext( TUint32 aContextId );
        
private: // Data
    
    /**
     * Array contains the Crypto contexts.
     */
    RArray<TMccCryptoContext> iContextArray;

    };
     
    
#endif /* MMCCCRYPTOCONTEXTCONTAINER_H */