Main Page | Modules | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Class Members | File Members | Related Pages

CTMemoryCard Class Reference
[General Card Classes]

Basic class for memory cards. More...

#include <ctmemorycard.h>

Inheritance diagram for CTMemoryCard:

CTCard CTCardBase CTKVKCard List of all members.

Public Member Functions

Constructors/Destructor
Methods to retrieve the private members of this class.

 CTMemoryCard (const CTCard &c)
virtual ~CTMemoryCard ()
Opening and closing operations
Methods to connect and disconnect the card. Most other methods only work if the card is open.

virtual CTError reopenCard ()
Informational methods
These methods tell you about the type and the status of the card.

virtual string cardType ()
virtual string cardTypes ()
Commands
These methods allow you to send a command to the card. Of course the card needs to be already open.

CTError verifyPin (const string &pin)
CTError changePin (const string &oldpin, const string &newpin)
CTError selectFile (unsigned short fid)
CTError selectMF (string &fcp)

Detailed Description

Basic class for memory cards.

This class provides access to memory chip cards. It allows you to do some very basic things with memory cards, like reading from them or writing to them.

Author:
Martin Preuss<martin@libchipcard.de>


Constructor & Destructor Documentation

CTMemoryCard::CTMemoryCard const CTCard c  ) 
 

virtual CTMemoryCard::~CTMemoryCard  )  [virtual]
 


Member Function Documentation

virtual string CTMemoryCard::cardType  )  [virtual]
 

This method returns a short name of the class which handles this card. A HBCI card for example returns "HBCICard". So you can use this method to check for the type of the card.

Reimplemented from CTCard.

Reimplemented in CTKVKCard.

virtual string CTMemoryCard::cardTypes  )  [virtual]
 

This method returns a comma separated list of all card types this card inherits including the type of this card, e.g. a HBCI card would return "CTProcessorCard, HBCICard". If you overload this method in your own class (you SHOULD) you simply have to call this method of the class it directly inherits. That class will then do the same, so that there is a list upon return.

Reimplemented from CTCard.

Reimplemented in CTKVKCard.

CTError CTMemoryCard::changePin const string &  oldpin,
const string &  newpin
 

Changes the pin on the card.

Author:
Martin Preuss<martin@libchipcard.de>
Parameters:
oldpin the pin
newpin new pin
Returns:
CTError object that holds the result (call isOk() to see if there was an error)

virtual CTError CTMemoryCard::reopenCard  )  [virtual]
 

When this method is called normally the card is already opened by means of openCard(). However, it is likely that openCard() has been called assuming this card is only a CTCard() object, nothing special. You may then call THIS method here on all known card classes to check for the type of this card. This method must assume that any file on the card is already selected, so it is in most cases a good idea to select the MF as the first action of this method. If the executing class finds that the card inserted is not of a type it can handle then it MUST return an error.

Reimplemented from CTCard.

Reimplemented in CTKVKCard.

CTError CTMemoryCard::selectFile unsigned short  fid  ) 
 

Selects a file. Please not that some cards only allow this method to be called with a fid=0x3f00.

Author:
Martin Preuss<martin@libchipcard.de>
Parameters:
fid the id of the file to select (0x3f00 for MF)
Returns:
CTError object that holds the result (call isOk() to see if there was an error)

CTError CTMemoryCard::selectMF string &  fcp  ) 
 

Selects the master file. On success the FCI (File Control Information) is returned. The FCI may contain some usefull information about access rights you have for the file. For a closer information about FCI see the file "geldkarte.pdf" which may be obtained from the Chaos Computer Club (CCC). Please note that some cards do not support this command. In that case you have to use the basic method CTCard::selectFile().

Author:
Martin Preuss<martin@libchipcard.de>
Returns:
CTError object that holds the result (call isOk() to see if there was an error)
Parameters:
fcp a reference to a string to receive the FCI

CTError CTMemoryCard::verifyPin const string &  pin  ) 
 

Lets the card verify the pin. Some cards may need this to allow writing to it.

Author:
Martin Preuss<martin@libchipcard.de>
Parameters:
pin hmm ;-)
Returns:
CTError object that holds the result (call isOk() to see if there was an error)


The documentation for this class was generated from the following file:
Generated on Sat Feb 11 15:20:28 2006 for libchipcard by  doxygen 1.4.2