pcsclite.h

Go to the documentation of this file.
00001 /*
00002  * MUSCLE SmartCard Development ( http://www.linuxnet.com )
00003  *
00004  * Copyright (C) 1999-2004
00005  *  David Corcoran <corcoran@linuxnet.com>
00006  * Copyright (C) 2002-2009
00007  *  Ludovic Rousseau <ludovic.rousseau@free.fr>
00008  * Copyright (C) 2005
00009  *  Martin Paljak <martin@paljak.pri.ee>
00010  *
00011  * $Id: pcsclite.h.in 5134 2010-08-15 14:48:18Z rousseau $
00012  */
00013 
00021 #ifndef __pcsclite_h__
00022 #define __pcsclite_h__
00023 
00024 #include <wintypes.h>
00025 
00026 #ifdef __cplusplus
00027 extern "C"
00028 {
00029 #endif
00030 
00031 typedef long SCARDCONTEXT; 
00032 typedef SCARDCONTEXT *PSCARDCONTEXT;
00033 typedef SCARDCONTEXT *LPSCARDCONTEXT;
00034 typedef long SCARDHANDLE; 
00035 typedef SCARDHANDLE *PSCARDHANDLE;
00036 typedef SCARDHANDLE *LPSCARDHANDLE;
00037 
00038 #define MAX_ATR_SIZE            33  
00040 typedef struct
00041 {
00042     const char *szReader;
00043     void *pvUserData;
00044     unsigned long dwCurrentState;
00045     unsigned long dwEventState;
00046     unsigned long cbAtr;
00047     unsigned char rgbAtr[MAX_ATR_SIZE];
00048 }
00049 SCARD_READERSTATE, *LPSCARD_READERSTATE;
00050 
00052 typedef struct
00053 {
00054     unsigned long dwProtocol;   
00055     unsigned long cbPciLength;  
00056 }
00057 SCARD_IO_REQUEST, *PSCARD_IO_REQUEST, *LPSCARD_IO_REQUEST;
00058 
00059 typedef const SCARD_IO_REQUEST *LPCSCARD_IO_REQUEST;
00060 
00061 extern SCARD_IO_REQUEST g_rgSCardT0Pci, g_rgSCardT1Pci, g_rgSCardRawPci;
00062 
00063 #define SCARD_PCI_T0    (&g_rgSCardT0Pci) 
00064 #define SCARD_PCI_T1    (&g_rgSCardT1Pci) 
00065 #define SCARD_PCI_RAW   (&g_rgSCardRawPci) 
00069 #define SCARD_S_SUCCESS         ((LONG)0x00000000) 
00070 #define SCARD_F_INTERNAL_ERROR      ((LONG)0x80100001) 
00071 #define SCARD_E_CANCELLED       ((LONG)0x80100002) 
00072 #define SCARD_E_INVALID_HANDLE      ((LONG)0x80100003) 
00073 #define SCARD_E_INVALID_PARAMETER   ((LONG)0x80100004) 
00074 #define SCARD_E_INVALID_TARGET      ((LONG)0x80100005) 
00075 #define SCARD_E_NO_MEMORY       ((LONG)0x80100006) 
00076 #define SCARD_F_WAITED_TOO_LONG     ((LONG)0x80100007) 
00077 #define SCARD_E_INSUFFICIENT_BUFFER ((LONG)0x80100008) 
00078 #define SCARD_E_UNKNOWN_READER      ((LONG)0x80100009) 
00079 #define SCARD_E_TIMEOUT         ((LONG)0x8010000A) 
00080 #define SCARD_E_SHARING_VIOLATION   ((LONG)0x8010000B) 
00081 #define SCARD_E_NO_SMARTCARD        ((LONG)0x8010000C) 
00082 #define SCARD_E_UNKNOWN_CARD        ((LONG)0x8010000D) 
00083 #define SCARD_E_CANT_DISPOSE        ((LONG)0x8010000E) 
00084 #define SCARD_E_PROTO_MISMATCH      ((LONG)0x8010000F) 
00085 #define SCARD_E_NOT_READY       ((LONG)0x80100010) 
00086 #define SCARD_E_INVALID_VALUE       ((LONG)0x80100011) 
00087 #define SCARD_E_SYSTEM_CANCELLED    ((LONG)0x80100012) 
00088 #define SCARD_F_COMM_ERROR      ((LONG)0x80100013) 
00089 #define SCARD_F_UNKNOWN_ERROR       ((LONG)0x80100014) 
00090 #define SCARD_E_INVALID_ATR     ((LONG)0x80100015) 
00091 #define SCARD_E_NOT_TRANSACTED      ((LONG)0x80100016) 
00092 #define SCARD_E_READER_UNAVAILABLE  ((LONG)0x80100017) 
00093 #define SCARD_P_SHUTDOWN        ((LONG)0x80100018) 
00094 #define SCARD_E_PCI_TOO_SMALL       ((LONG)0x80100019) 
00095 #define SCARD_E_READER_UNSUPPORTED  ((LONG)0x8010001A) 
00096 #define SCARD_E_DUPLICATE_READER    ((LONG)0x8010001B) 
00097 #define SCARD_E_CARD_UNSUPPORTED    ((LONG)0x8010001C) 
00098 #define SCARD_E_NO_SERVICE      ((LONG)0x8010001D) 
00099 #define SCARD_E_SERVICE_STOPPED     ((LONG)0x8010001E) 
00100 #define SCARD_E_UNEXPECTED      ((LONG)0x8010001F) 
00101 #define SCARD_E_UNSUPPORTED_FEATURE ((LONG)0x8010001F) 
00102 #define SCARD_E_ICC_INSTALLATION    ((LONG)0x80100020) 
00103 #define SCARD_E_ICC_CREATEORDER     ((LONG)0x80100021) 
00104 /* #define SCARD_E_UNSUPPORTED_FEATURE  ((LONG)0x80100022) / **< This smart card does not support the requested feature. */
00105 #define SCARD_E_DIR_NOT_FOUND       ((LONG)0x80100023) 
00106 #define SCARD_E_FILE_NOT_FOUND      ((LONG)0x80100024) 
00107 #define SCARD_E_NO_DIR          ((LONG)0x80100025) 
00108 #define SCARD_E_NO_FILE         ((LONG)0x80100026) 
00109 #define SCARD_E_NO_ACCESS       ((LONG)0x80100027) 
00110 #define SCARD_E_WRITE_TOO_MANY      ((LONG)0x80100028) 
00111 #define SCARD_E_BAD_SEEK        ((LONG)0x80100029) 
00112 #define SCARD_E_INVALID_CHV     ((LONG)0x8010002A) 
00113 #define SCARD_E_UNKNOWN_RES_MNG     ((LONG)0x8010002B) 
00114 #define SCARD_E_NO_SUCH_CERTIFICATE ((LONG)0x8010002C) 
00115 #define SCARD_E_CERTIFICATE_UNAVAILABLE ((LONG)0x8010002D) 
00116 #define SCARD_E_NO_READERS_AVAILABLE    ((LONG)0x8010002E) 
00117 #define SCARD_E_COMM_DATA_LOST      ((LONG)0x8010002F) 
00118 #define SCARD_E_NO_KEY_CONTAINER    ((LONG)0x80100030) 
00119 #define SCARD_E_SERVER_TOO_BUSY     ((LONG)0x80100031) 
00121 #define SCARD_W_UNSUPPORTED_CARD    ((LONG)0x80100065) 
00122 #define SCARD_W_UNRESPONSIVE_CARD   ((LONG)0x80100066) 
00123 #define SCARD_W_UNPOWERED_CARD      ((LONG)0x80100067) 
00124 #define SCARD_W_RESET_CARD      ((LONG)0x80100068) 
00125 #define SCARD_W_REMOVED_CARD        ((LONG)0x80100069) 
00127 #define SCARD_W_SECURITY_VIOLATION  ((LONG)0x8010006A) 
00128 #define SCARD_W_WRONG_CHV       ((LONG)0x8010006B) 
00129 #define SCARD_W_CHV_BLOCKED     ((LONG)0x8010006C) 
00130 #define SCARD_W_EOF         ((LONG)0x8010006D) 
00131 #define SCARD_W_CANCELLED_BY_USER   ((LONG)0x8010006E) 
00132 #define SCARD_W_CARD_NOT_AUTHENTICATED  ((LONG)0x8010006F) 
00134 #define SCARD_AUTOALLOCATE (DWORD)(-1)  
00135 #define SCARD_SCOPE_USER        0x0000  
00136 #define SCARD_SCOPE_TERMINAL        0x0001  
00137 #define SCARD_SCOPE_SYSTEM      0x0002  
00139 #define SCARD_PROTOCOL_UNDEFINED    0x0000  
00140 #define SCARD_PROTOCOL_UNSET SCARD_PROTOCOL_UNDEFINED   /* backward compat */
00141 #define SCARD_PROTOCOL_T0       0x0001  
00142 #define SCARD_PROTOCOL_T1       0x0002  
00143 #define SCARD_PROTOCOL_RAW      0x0004  
00144 #define SCARD_PROTOCOL_T15      0x0008  
00146 #define SCARD_PROTOCOL_ANY      (SCARD_PROTOCOL_T0|SCARD_PROTOCOL_T1)   
00148 #define SCARD_SHARE_EXCLUSIVE       0x0001  
00149 #define SCARD_SHARE_SHARED      0x0002  
00150 #define SCARD_SHARE_DIRECT      0x0003  
00152 #define SCARD_LEAVE_CARD        0x0000  
00153 #define SCARD_RESET_CARD        0x0001  
00154 #define SCARD_UNPOWER_CARD      0x0002  
00155 #define SCARD_EJECT_CARD        0x0003  
00157 #define SCARD_UNKNOWN           0x0001  
00158 #define SCARD_ABSENT            0x0002  
00159 #define SCARD_PRESENT           0x0004  
00160 #define SCARD_SWALLOWED         0x0008  
00161 #define SCARD_POWERED           0x0010  
00162 #define SCARD_NEGOTIABLE        0x0020  
00163 #define SCARD_SPECIFIC          0x0040  
00165 #define SCARD_STATE_UNAWARE     0x0000  
00166 #define SCARD_STATE_IGNORE      0x0001  
00167 #define SCARD_STATE_CHANGED     0x0002  
00168 #define SCARD_STATE_UNKNOWN     0x0004  
00169 #define SCARD_STATE_UNAVAILABLE     0x0008  
00170 #define SCARD_STATE_EMPTY       0x0010  
00171 #define SCARD_STATE_PRESENT     0x0020  
00172 #define SCARD_STATE_ATRMATCH        0x0040  
00173 #define SCARD_STATE_EXCLUSIVE       0x0080  
00174 #define SCARD_STATE_INUSE       0x0100  
00175 #define SCARD_STATE_MUTE        0x0200  
00176 #define SCARD_STATE_UNPOWERED       0x0400  
00178 #ifndef INFINITE
00179 #define INFINITE            0xFFFFFFFF  
00180 #endif
00181 
00182 #define PCSCLITE_VERSION_NUMBER     "1.6.4" 
00184 #define PCSCLITE_MAX_READERS_CONTEXTS           16
00185 
00186 #define MAX_READERNAME          100
00187 
00188 #ifndef SCARD_ATR_LENGTH
00189 #define SCARD_ATR_LENGTH        MAX_ATR_SIZE    
00190 #endif
00191 
00192 /*
00193  * The message and buffer sizes must be multiples of 16.
00194  * The max message size must be at least large enough
00195  * to accomodate the transmit_struct
00196  */
00197 #define MAX_BUFFER_SIZE         264 
00198 #define MAX_BUFFER_SIZE_EXTENDED    (4 + 3 + (1<<16) + 3)   
00200 /*
00201  * Gets a stringified error response
00202  */
00203 char *pcsc_stringify_error(const long);
00204 
00205 #ifdef __cplusplus
00206 }
00207 #endif
00208 
00209 #endif