/*

* 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:  Keeps track, creates and destroys connector objects

*

*/

#ifndef CSCARDCONNECTIONREGISTRY_H

#define CSCARDCONNECTIONREGISTRY_H

// INCLUDE FILES

#include "ScardDefs.h"

//FORWARD DECLARATIONS

class CScardAccessControlRegistry;

class CScardAccessControl;

class CScardServer;

class CScardConnector;

class CScardSession;

class MScardReader;

// DATA TYPES

struct TConnectionHandle

    {

    CScardConnector* iConnector;  // This is introduced in forward declarations

    CScardSession*   iClient;

    TConnectionHandle()

        :iConnector( NULL ), iClient( NULL )

        {}

    };

// CLASS DECLARATION

/**

*  Keeps track, creates and destroys connector objects.

*

*  @lib Scard.lib

*  @since Series60 2.1

*/

class CScardConnectionRegistry : public CBase

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param aServer Pointer to server object

        */

        static CScardConnectionRegistry* NewL( CScardServer* aServer );

        /**

        * Destructor.

        */

        virtual ~CScardConnectionRegistry();

    public: // New functions

        /**

        * Creates the connector and instructs it to connect.

        * @param aSession Pointer to session

        * @param aMessage Message

        * @return void

        */

        void ConnectToReaderL( CScardSession* aSession, 

                               const RMessage2& aMessage );

        /**

        * Finds the connector managing the session and instructs it cancel. 

        * Panics if the connector is not found.

        * @param aSession

        * @return void

        */

        void CancelConnection( CScardSession* aSession );

        /**

        * Connection completed.

        * @param aConnector Pointer to connector

        * @param aReaderID Reader ID

        * @param aErrorCode Error code that is returned in error

        * @return void

        */

        void ConnectDone( CScardConnector* aConnector, 

                          const TReaderID& aReaderID, 

                          const TInt& aErrorCode );

        /**

        * Removes connector from registry.

        * @param aConnector Pointer to connector to be removed

        * @return void

        */

        void RemoveConnector( CScardConnector* aConnector );

        /**

        * Return pointer to ScardServer object

        * @return Pointer to ScardServer object

        */

        CScardServer* Server() const;

        /**

        * Return connection handle

        * @param aLocation Index in iConnectors array

        * @return Connection handle

        */

        TConnectionHandle& Connection( TInt aLocation ) const;

    private:

        /**

        * C++ default constructor.

        */

        CScardConnectionRegistry();

        /**

        * By default Symbian 2nd phase constructor is private.

        * @param aServer Pointer to server object

        */

        void ConstructL( CScardServer* aServer );

    private:    // Data

        // Pointer to Scard Server. Not owned.

        CScardServer* iServer;

        // Array of connectors. Owned.

        CArrayFixFlat<TConnectionHandle>* iConnectors;

    };

#endif      // CSCARDCONNECTIONREGISTRY_H

// End of File