1 /*

     2 * Copyright (c) 2003 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  This file contains definition of abstract Card Reader Launcher

    15 *               interface class from which the final Reader Launcher classes 

    16 *               are derived.

    17 *

    18 */

    19 

    20 

    21 

    22 #ifndef SCARDREADERLAUNCHER_H

    23 #define SCARDREADERLAUNCHER_H

    24 

    25 //  INCLUDES

    26 #include "ScardReader.h"

    27 #include "ScardNotifyObserver.h"

    28 

    29 //  CONSTANTS  

    30 

    31 // The UID for Card Reader DLLs.

    32 // The client imposes this on DLLs which are required

    33 // to satisfy the protocol 

    34 

    35 const TInt KReaderLauncherUidValue = 0x1000086E;

    36 const TUid KReaderLauncherUid      = {KReaderUidValue};

    37 

    38 // CLASS DECLARATION

    39 

    40 /**

    41 *  Defines pure virtual functions for getting notifyobservers.

    42 *

    43 *  @lib Scard.lib

    44 *  @since Series60 2.1

    45 */

    46 class MScardReaderService 

    47     {

    48 

    49     public:

    50         /**

    51         * Return notify observer object

    52         * @return Pointer to MScardNotifyObserver

    53         */

    54         virtual MScardNotifyObserver* NotifyObserver() = 0;

    55 

    56     };

    57 

    58 // CLASS DECLARATION

    59 

    60 /**

    61 *  Defines pure virtual functions for load and unload service resources.

    62 *

    63 *  @lib Scard.lib

    64 *  @since Series60 2.1

    65 */

    66 class MScardReaderLauncher

    67     {

    68 

    69     public:  // Constructors and destructor

    70 

    71         /**

    72         * Reader service object is the one that Launcher can query needed 

    73         * information to connect reader for framework wide services.

    74         * @param aReaderService ReaderService

    75         * @return void

    76         */

    77         virtual void ConstructL( MScardReaderService* aReaderService ) = 0;

    78 

    79     public: // New functions

    80  

    81         /**

    82         * Create specific reader object, just create not attach the physical

    83         * reader device, Open() in Reader interface will do this.

    84         * @param aReaderID Reader ID

    85         * @return Pointer to MScardReader object

    86         */

    87         virtual MScardReader* CreateReaderL( TReaderID aReaderID ) = 0;

    88 

    89         /**

    90         * Delete the reader object, should be Closed() before this is called

    91         * @param aReaderID Reader ID

    92         * @return void

    93         */

    94         virtual void DeleteReader( TReaderID aReaderID ) = 0;

    95 

    96     };

    97     

    98 #endif      // SCARDREADERLAUNCHER_H

    99 

   100 // End of File