/*
* 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:   The header file of DevandTruSrvCertStoreEntryList
*
*/



#ifndef __DEVANDTRUSRVCERTSTOREENTRYLIST_H__
#define __DEVANDTRUSRVCERTSTOREENTRYLIST_H__

#include <s32file.h>

class CDevandTruSrvCertStoreEntry;

/**
 * An in-memory list of the certs in the store
 *
 * @lib
 * @since S60 v3.2.
 */
class CDevandTruSrvCertStoreEntryList : public CBase
    {
    public:
    
        // Create a new, empty cert list
        static CDevandTruSrvCertStoreEntryList* NewLC();

        // Read the cert list from a stream
        static CDevandTruSrvCertStoreEntryList* NewL(RReadStream& aStream);

        virtual ~CDevandTruSrvCertStoreEntryList();

        // Write the cert list to a stream
        void ExternalizeL(RWriteStream& aStream) const;

        // Get the number of certificates in the list
        TInt Count() const;

        /**
         * Get the index of a mapping given the cert handle
         *
         * @param aHandle 
         * @return The index of the cert or KErrNotFound if it is not present
         */
        TInt IndexForHandle(TInt aHandle) const;

        // Determine whether a certificate exists with the specified label
        TBool LabelExists(const TDesC& aLabel) const;

        /**
         * Get a mapping given the cert handle
         * leave KErrNotFound If the specified cert is not present
         * 
         * @param aHandle 
         * @return 
         */
        const CDevandTruSrvCertStoreEntry& GetByHandleL(TInt aHandle) const;

        // Get a mapping given its index.
        const CDevandTruSrvCertStoreEntry& GetByIndex(TInt aIndex) const;

        // Get the next free handle to use when adding a cert
        TInt NextFreeHandle() const;

        // Add a mapping and return its index, takes ownership
        TInt AppendL(CDevandTruSrvCertStoreEntry* aEntry);

        // Removes and returns an entry from the list, relinquishes ownership
        CDevandTruSrvCertStoreEntry* Remove(TInt aIndex);

        // Replace an entry and return the old one, takes/relinquishes ownership
        CDevandTruSrvCertStoreEntry* Replace(TInt aIndex, CDevandTruSrvCertStoreEntry* aEntry); 

    private:
        
        CDevandTruSrvCertStoreEntryList();
        
        void InternalizeL(RReadStream& aStream);

    private:
        
        RPointerArray<CDevandTruSrvCertStoreEntry> iEntries;
    };

#endif //__DEVANDTRUSRVCERTSTOREENTRYLIST_H__

//EOF