#include "config.h"
#include <stdlib.h>
#include <string.h>
#include <sys/types.h>
#include <fcntl.h>
#include <unistd.h>
#include <sys/un.h>
#include <errno.h>
#include "misc.h"
#include "pcsclite.h"
#include "winscard.h"
#include "debug.h"
#include "thread_generic.h"
#include "readerfactory.h"
#include "eventhandler.h"
#include "sys_generic.h"
#include "winscard_msg.h"
Go to the source code of this file.
Data Structures | |
struct | _psChannelMap |
Represents an Application Context Channel. More... | |
struct | _psContextMap |
Represents the an Application Context on the Client side. More... | |
Defines | |
#define | SCARD_PROTOCOL_ANY_OLD 0x1000 |
used for backward compatibility | |
#define | min(a, b) (((a) < (b)) ? (a) : (b)) |
#define | TRUE 1 |
#define | FALSE 0 |
#define | PROFILE_START |
#define | PROFILE_END |
Typedefs | |
typedef _psChannelMap | CHANNEL_MAP |
typedef _psChannelMap * | PCHANNEL_MAP |
Functions | |
static LONG | SCardAddContext (SCARDCONTEXT hContext, DWORD dwClientID) |
Adds an Application Context to the vector psContextMap . | |
static LONG | SCardGetContextIndice (SCARDCONTEXT hContext) |
Get the index from the Application Context vector psContextMap for the passed context. | |
static LONG | SCardGetContextIndiceTH (SCARDCONTEXT hContext) |
Get the index from the Application Context vector psContextMap for the passed context. | |
static LONG | SCardRemoveContext (SCARDCONTEXT hContext) |
Removes an Application Context from a control vector. | |
static LONG | SCardAddHandle (SCARDHANDLE, DWORD, LPTSTR) |
static LONG | SCardGetIndicesFromHandle (SCARDHANDLE, PDWORD, PDWORD) |
static LONG | SCardGetIndicesFromHandleTH (SCARDHANDLE, PDWORD, PDWORD) |
static LONG | SCardRemoveHandle (SCARDHANDLE) |
static LONG | SCardGetSetAttrib (SCARDHANDLE hCard, int command, DWORD dwAttrId, LPBYTE pbAttr, LPDWORD pcbAttrLen) |
static LONG | SCardCheckDaemonAvailability (void) |
Checks if the Server is running. | |
static LONG | SCardLockThread (void) |
This function locks a mutex so another thread must wait to use this function. | |
static LONG | SCardUnlockThread (void) |
This function unlocks a mutex so another thread may use the client. | |
static LONG | SCardEstablishContextTH (DWORD dwScope, LPCVOID pvReserved1, LPCVOID pvReserved2, LPSCARDCONTEXT phContext) |
Creates a communication context to the PC/SC Resource Manager. | |
LONG | SCardEstablishContext (DWORD dwScope, LPCVOID pvReserved1, LPCVOID pvReserved2, LPSCARDCONTEXT phContext) |
Creates an Application Context for a client. | |
LONG | SCardReleaseContext (SCARDCONTEXT hContext) |
This function destroys a communication context to the PC/SC Resource Manager. | |
LONG | SCardSetTimeout (SCARDCONTEXT hContext, DWORD dwTimeout) |
LONG | SCardConnect (SCARDCONTEXT hContext, LPCTSTR szReader, DWORD dwShareMode, DWORD dwPreferredProtocols, LPSCARDHANDLE phCard, LPDWORD pdwActiveProtocol) |
This function establishes a connection to the friendly name of the reader specified in szReader. | |
LONG | SCardReconnect (SCARDHANDLE hCard, DWORD dwShareMode, DWORD dwPreferredProtocols, DWORD dwInitialization, LPDWORD pdwActiveProtocol) |
This function reestablishes a connection to a reader that was previously connected to using SCardConnect(). | |
LONG | SCardDisconnect (SCARDHANDLE hCard, DWORD dwDisposition) |
This function terminates a connection to the connection made through SCardConnect(). | |
LONG | SCardBeginTransaction (SCARDHANDLE hCard) |
This function establishes a temporary exclusive access mode for doing a series of commands or transaction. | |
LONG | SCardEndTransaction (SCARDHANDLE hCard, DWORD dwDisposition) |
This function ends a previously begun transaction. | |
LONG | SCardCancelTransaction (SCARDHANDLE hCard) |
LONG | SCardStatus (SCARDHANDLE hCard, LPTSTR mszReaderNames, LPDWORD pcchReaderLen, LPDWORD pdwState, LPDWORD pdwProtocol, LPBYTE pbAtr, LPDWORD pcbAtrLen) |
This function returns the current status of the reader connected to by hCard. | |
LONG | SCardGetStatusChange (SCARDCONTEXT hContext, DWORD dwTimeout, LPSCARD_READERSTATE_A rgReaderStates, DWORD cReaders) |
This function receives a structure or list of structures containing reader names. | |
LONG | SCardControl (SCARDHANDLE hCard, DWORD dwControlCode, LPCVOID pbSendBuffer, DWORD cbSendLength, LPVOID pbRecvBuffer, DWORD cbRecvLength, LPDWORD lpBytesReturned) |
This function sends a command directly to the IFD Handler to be processed by the reader. | |
LONG | SCardGetAttrib (SCARDHANDLE hCard, DWORD dwAttrId, LPBYTE pbAttr, LPDWORD pcbAttrLen) |
This function get an attribute from the IFD Handler. | |
LONG | SCardSetAttrib (SCARDHANDLE hCard, DWORD dwAttrId, LPCBYTE pbAttr, DWORD cbAttrLen) |
This function set an attribute of the IFD Handler. | |
LONG | SCardTransmit (SCARDHANDLE hCard, LPCSCARD_IO_REQUEST pioSendPci, LPCBYTE pbSendBuffer, DWORD cbSendLength, LPSCARD_IO_REQUEST pioRecvPci, LPBYTE pbRecvBuffer, LPDWORD pcbRecvLength) |
This function sends an APDU to the smart card contained in the reader connected to by SCardConnect(). | |
LONG | SCardListReaders (SCARDCONTEXT hContext, LPCTSTR mszGroups, LPTSTR mszReaders, LPDWORD pcchReaders) |
This function returns a list of currently available readers on the system. | |
LONG | SCardListReaderGroups (SCARDCONTEXT hContext, LPTSTR mszGroups, LPDWORD pcchGroups) |
This function returns a list of currently available reader groups on the system. | |
LONG | SCardCancel (SCARDCONTEXT hContext) |
This function cancels all pending blocking requests on the SCardGetStatusChange() function. | |
void DESTRUCTOR | SCardUnload (void) |
free resources allocated by the library You _shall_ call this function if you use dlopen/dlclose to load/unload the library. | |
Variables | |
static struct _psContextMap | psContextMap [PCSCLITE_MAX_APPLICATION_CONTEXTS] |
Represents the an Application Context on the Client side. | |
static short | isExecuted = 0 |
Make sure the initialization code is executed only once. | |
static int | mapAddr = 0 |
Memory mapped address used to read status information about the readers. | |
static PCSCLITE_MUTEX | clientMutex = PTHREAD_MUTEX_INITIALIZER |
Ensure that some functions be accessed in thread-safe mode. | |
static PREADER_STATE | readerStates [PCSCLITE_MAX_READERS_CONTEXTS] |
Pointers to a memory mapped area used to read status information about the readers. | |
PCSC_API SCARD_IO_REQUEST | g_rgSCardT0Pci = { SCARD_PROTOCOL_T0, 8 } |
PCSC_API SCARD_IO_REQUEST | g_rgSCardT1Pci = { SCARD_PROTOCOL_T1, 8 } |
PCSC_API SCARD_IO_REQUEST | g_rgSCardRawPci = { SCARD_PROTOCOL_RAW, 8 } |
Here is exposed the API for client applications.
Definition in file winscard_clnt.c.
|
Adds an Application Context to the vector
Definition at line 2915 of file winscard_clnt.c. References BLOCK_STATUS_RESUME, _psContextMap::contextBlockStatus, _psContextMap::dwClientID, _psContextMap::mMutex, PCSCLITE_MUTEX, PCSCLITE_MUTEX_T, psContextMap, SCARD_S_SUCCESS, and SYS_MutexInit(). Referenced by getNewContext(). |
|
This function establishes a temporary exclusive access mode for doing a series of commands or transaction.
You might want to use this when you are selecting a few files and then writing a large file so you can make sure that another application will not change the current file. If another application has a lock on this reader or this application is in
SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); rv = SCardBeginTransaction(hCard); ... / * Do some transmit commands * / Definition at line 1010 of file winscard_clnt.c. References PCSCLITE_MAX_READERS_CONTEXTS, PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
This function cancels all pending blocking requests on the
SCARDCONTEXT hContext; DWORD cReaders; SCARD_READERSTATE rgReaderStates; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rgReaderStates.szReader = strdup("Reader X"); rgReaderStates.dwCurrentState = SCARD_STATE_EMPTY; ... / * Spawn off thread for following function * / ... rv = SCardGetStatusChange(hContext, 0, rgReaderStates, cReaders); rv = SCardCancel(hContext); Definition at line 2877 of file winscard_clnt.c. References BLOCK_STATUS_RESUME, _psContextMap::contextBlockStatus, PROFILE_END, PROFILE_START, psContextMap, SCARD_E_INVALID_HANDLE, SCARD_S_SUCCESS, and SCardGetContextIndice(). |
|
Definition at line 1251 of file winscard_clnt.c. References PCSCLITE_MAX_READERS_CONTEXTS, PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
Checks if the Server is running.
Definition at line 3133 of file winscard_clnt.c. References Log1, PCSCLITE_IPC_DIR, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, and SYS_Stat(). Referenced by SCardBeginTransaction(), SCardCancelTransaction(), SCardConnect(), SCardControl(), SCardDisconnect(), SCardEndTransaction(), SCardEstablishContextTH(), SCardGetSetAttrib(), SCardGetStatusChange(), SCardListReaderGroups(), SCardListReaders(), SCardReconnect(), SCardReleaseContext(), SCardStatus(), and SCardTransmit(). |
|
This function establishes a connection to the friendly name of the reader specified in szReader. The first connection will power up and perform a reset on the card.
SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); Definition at line 617 of file winscard_clnt.c. References rxSharedSegment::data, connect_struct::dwPreferredProtocols, connect_struct::dwShareMode, connect_struct::hContext, MAX_READERNAME, PCSCLITE_CLIENT_ATTEMPTS, connect_struct::pdwActiveProtocol, connect_struct::phCard, PROFILE_END, PROFILE_START, psContextMap, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_PARAMETER, SCARD_E_INVALID_VALUE, SCARD_E_NO_SERVICE, SCARD_E_UNKNOWN_READER, SCARD_F_COMM_ERROR, SCARD_PROTOCOL_ANY_OLD, SCARD_PROTOCOL_RAW, SCARD_PROTOCOL_T0, SCARD_PROTOCOL_T1, SCARD_S_SUCCESS, SCardAddHandle(), SCardCheckDaemonAvailability(), SCardGetContextIndice(), SHMClientRead(), SYS_MutexLock(), SYS_MutexUnLock(), connect_struct::szReader, and WrapSHMWrite(). |
|
This function sends a command directly to the IFD Handler to be processed by the reader. This is useful for creating client side reader drivers for functions like PIN pads, biometrics, or other extensions to the normal smart card reader that are not normally handled by PC/SC.
LONG rv; SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol, dwSendLength, dwRecvLength; BYTE pbRecvBuffer[10]; BYTE pbSendBuffer[] = { 0x06, 0x00, 0x0A, 0x01, 0x01, 0x10 0x00 }; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_RAW &hCard, &dwActiveProtocol); dwSendLength = sizeof(pbSendBuffer); dwRecvLength = sizeof(pbRecvBuffer); rv = SCardControl(hCard, 0x42000001, pbSendBuffer, dwSendLength, pbRecvBuffer, sizeof(pbRecvBuffer), &dwRecvLength); Definition at line 2157 of file winscard_clnt.c. References PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
This function terminates a connection to the connection made through SCardConnect(). dwDisposition can have the following values:
SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); rv = SCardDisconnect(hCard, SCARD_UNPOWER_CARD); Definition at line 912 of file winscard_clnt.c. References rxSharedSegment::data, disconnect_struct::dwDisposition, disconnect_struct::hCard, PCSCLITE_CLIENT_ATTEMPTS, PROFILE_END, PROFILE_START, psContextMap, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_VALUE, SCARD_E_NO_SERVICE, SCARD_EJECT_CARD, SCARD_F_COMM_ERROR, SCARD_LEAVE_CARD, SCARD_RESET_CARD, SCARD_S_SUCCESS, SCARD_UNPOWER_CARD, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), SCardRemoveHandle(), SHMClientRead(), SYS_MutexLock(), SYS_MutexUnLock(), and WrapSHMWrite(). |
|
This function ends a previously begun transaction. The calling application must be the owner of the previously begun transaction or an error will occur.
SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); rv = SCardBeginTransaction(hCard); ... / * Do some transmit commands * / ... rv = SCardEndTransaction(hCard, SCARD_LEAVE_CARD); Definition at line 1156 of file winscard_clnt.c. References PCSCLITE_MAX_READERS_CONTEXTS, PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_VALUE, SCARD_E_NO_SERVICE, SCARD_EJECT_CARD, SCARD_LEAVE_CARD, SCARD_RESET_CARD, SCARD_S_SUCCESS, SCARD_UNPOWER_CARD, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
Creates an Application Context for a client.
This must be the first function called in a PC/SC application. This is a thread-safe wrapper to the function
SCARDCONTEXT hContext; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); Definition at line 237 of file winscard_clnt.c. References PROFILE_END, PROFILE_START, SCardEstablishContextTH(), SCardLockThread(), and SCardUnlockThread(). |
|
Creates a communication context to the PC/SC Resource Manager.
This function shuld not be called directly. Instead, the thread-safe function
Definition at line 279 of file winscard_clnt.c. References Log1, Log2, PCSCLITE_MAX_READERS_CONTEXTS, PCSCLITE_PUBSHM_FILE, readerStates, SCARD_E_INVALID_PARAMETER, SCARD_E_NO_SERVICE, SCARD_F_INTERNAL_ERROR, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SYS_CloseFile(), SYS_GetPageSize(), SYS_Initialize(), SYS_OpenFile(), and SYS_PublicMemoryMap(). Referenced by SCardEstablishContext(). |
|
This function get an attribute from the IFD Handler.
The list of possible attributes is available in the file
LONG rv; SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; unsigned char pbAtr[MAX_ATR_SIZE]; DWORD dwAtrLen; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_RAW &hCard, &dwActiveProtocol); rv = SCardGetAttrib(hCard, SCARD_ATTR_ATR_STRING, pbAtr, &dwAtrLen); Definition at line 2336 of file winscard_clnt.c. References MAX_BUFFER_SIZE, PROFILE_END, PROFILE_START, SCARD_E_INVALID_PARAMETER, and SCardGetSetAttrib(). |
|
Get the index from the Application Context vector
This function is a thread-safe wrapper to the function
Definition at line 2947 of file winscard_clnt.c. References SCardGetContextIndiceTH(), SCardLockThread(), and SCardUnlockThread(). Referenced by getNewContext(), getSessionForContext(), SCardCancel(), SCardCancelTH(), SCardConnect(), SCardConnectTH(), SCardGetStatusChange(), SCardListReaderGroups(), SCardListReaderGroupsTH(), SCardListReaders(), SCardListReadersTH(), SCardReleaseContext(), and SCardRemoveContext(). |
|
Get the index from the Application Context vector
This functions is not thread-safe and should not be called. Instead, call the function
Definition at line 2970 of file winscard_clnt.c. References psContextMap. Referenced by SCardGetContextIndice(), and SCardRemoveContext(). |
|
This function receives a structure or list of structures containing reader names. It then blocks for a change in state to occur on any of the OR'd values contained in dwCurrentState for a maximum blocking time of dwTimeout or forever if INFINITE is used. The new event state will be contained in dwEventState. A status change might be a card insertion or removal event, a change in ATR, etc. This function will block for reader availability if cReaders is equal to zero and rgReaderStates is NULL.
typedef struct { LPCTSTR szReader; // Reader name LPVOID pvUserData; // User defined data DWORD dwCurrentState; // Current state of reader DWORD dwEventState; // Reader state after a state change DWORD cbAtr; // ATR Length, usually MAX_ATR_SIZE BYTE rgbAtr[MAX_ATR_SIZE]; // ATR Value } SCARD_READERSTATE; ... typedef SCARD_READERSTATE *PSCARD_READERSTATE, **LPSCARD_READERSTATE; ... Value of dwCurrentState and dwEventState:
SCARDCONTEXT hContext; SCARD_READERSTATE_A rgReaderStates[1]; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); ... rgReaderStates[0].szReader = "Reader X"; rgReaderStates[0].dwCurrentState = SCARD_STATE_UNAWARE; ... rv = SCardGetStatusChange(hContext, INFINITE, rgReaderStates, 1); printf("reader state: 0x%04X\n", rgReaderStates[0].dwEventState); Definition at line 1605 of file winscard_clnt.c. References PCSCLITE_MAX_READERS_CONTEXTS, PROFILE_END, PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_PARAMETER, SCARD_E_INVALID_VALUE, SCARD_E_NO_SERVICE, SCARD_E_READER_UNAVAILABLE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetContextIndice(), SYS_MutexLock(), and SYS_MutexUnLock(). |
|
This function returns a list of currently available reader groups on the system.
The group names is a multi-string and separated by a nul character ('\0') and ended by a double nul character. "SCard$DefaultReaders\\0Group 2\\0\\0".
SCARDCONTEXT hContext; LPTSTR mszGroups; DWORD dwGroups; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardListReaderGroups(hContext, NULL, &dwGroups); mszGroups = (LPTSTR)malloc(sizeof(char)*dwGroups); rv = SCardListReaderGroups(hContext, mszGroups, &dwGroups); Definition at line 2806 of file winscard_clnt.c. References PROFILE_END, PROFILE_START, psContextMap, SCARD_E_INSUFFICIENT_BUFFER, SCARD_E_INVALID_HANDLE, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetContextIndice(), SYS_MutexLock(), and SYS_MutexUnLock(). |
|
This function returns a list of currently available readers on the system.
SCARDCONTEXT hContext; LPTSTR mszReaders; DWORD dwReaders; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardListReaders(hContext, NULL, NULL, &dwReaders); mszReaders = (LPTSTR)malloc(sizeof(char)*dwReaders); rv = SCardListReaders(hContext, NULL, mszReaders, &dwReaders); Definition at line 2702 of file winscard_clnt.c. References PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_PARAMETER, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetContextIndice(), SYS_MutexLock(), and SYS_MutexUnLock(). |
|
This function locks a mutex so another thread must wait to use this function.
Wrapper to the function Definition at line 3111 of file winscard_clnt.c. References clientMutex, and SYS_MutexLock(). Referenced by SCardBeginTransaction(), SCardCancel(), SCardCancelTransaction(), SCardConnect(), SCardDisconnect(), SCardEndTransaction(), SCardEstablishContext(), SCardGetContextIndice(), SCardGetIndicesFromHandle(), SCardGetStatusChange(), SCardListReaderGroups(), SCardListReaders(), SCardReconnect(), SCardReleaseContext(), SCardStatus(), and SCardTransmit(). |
|
This function reestablishes a connection to a reader that was previously connected to using SCardConnect(). In a multi application environment it is possible for an application to reset the card in shared mode. When this occurs any other application trying to access certain commands will be returned the value SCARD_W_RESET_CARD. When this occurs SCardReconnect() must be called in order to acknowledge that the card was reset and allow it to change it's state accordingly.
SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol, dwSendLength, dwRecvLength; LONG rv; BYTE pbRecvBuffer[10]; BYTE pbSendBuffer[] = {0xC0, 0xA4, 0x00, 0x00, 0x02, 0x3F, 0x00}; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); ... dwSendLength = sizeof(pbSendBuffer); dwRecvLength = sizeof(pbRecvBuffer); rv = SCardTransmit(hCard, SCARD_PCI_T0, pbSendBuffer, dwSendLength, &pioRecvPci, pbRecvBuffer, &dwRecvLength); / * Card has been reset by another application * / if (rv == SCARD_W_RESET_CARD) { rv = SCardReconnect(hCard, SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, SCARD_RESET_CARD, &dwActiveProtocol); } Definition at line 784 of file winscard_clnt.c. References PCSCLITE_MAX_READERS_CONTEXTS, PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_PARAMETER, SCARD_E_INVALID_VALUE, SCARD_E_NO_SERVICE, SCARD_EJECT_CARD, SCARD_LEAVE_CARD, SCARD_PROTOCOL_ANY_OLD, SCARD_PROTOCOL_RAW, SCARD_PROTOCOL_T0, SCARD_PROTOCOL_T1, SCARD_RESET_CARD, SCARD_S_SUCCESS, SCARD_UNPOWER_CARD, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
This function destroys a communication context to the PC/SC Resource Manager. This must be the last function called in a PC/SC application.
SCARDCONTEXT hContext; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardReleaseContext(hContext); Definition at line 488 of file winscard_clnt.c. References rxSharedSegment::data, release_struct::hContext, PCSCLITE_CLIENT_ATTEMPTS, PCSCLITE_MCLIENT_ATTEMPTS, PROFILE_END, PROFILE_START, psContextMap, release_struct::rv, SCARD_E_INVALID_HANDLE, SCARD_E_NO_SERVICE, SCARD_F_COMM_ERROR, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetContextIndice(), SCardLockThread(), SCardRemoveContext(), SCardUnlockThread(), SHMClientRead(), SYS_MutexLock(), SYS_MutexUnLock(), and WrapSHMWrite(). |
|
Removes an Application Context from a control vector.
Definition at line 2995 of file winscard_clnt.c. References BLOCK_STATUS_RESUME, _psContextMap::contextBlockStatus, _psContextMap::dwClientID, _psContextMap::hContext, _psContextMap::mMutex, PCSCLITE_MAX_APPLICATION_CONTEXT_CHANNELS, _psContextMap::psChannelMap, psContextMap, _psChannelMap::readerName, SCARD_E_INVALID_HANDLE, SCARD_S_SUCCESS, SCardGetContextIndiceTH(), and SHMClientCloseSession(). Referenced by SCardReleaseContext(), and SCardReleaseContextTH(). |
|
This function set an attribute of the IFD Handler. The list of attributes you can set is dependent on the IFD Handler you are using.
LONG rv; SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; unsigned char pbAtr[MAX_ATR_SIZE]; DWORD dwAtrLen; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_RAW &hCard, &dwActiveProtocol); rv = SCardSetAttrib(hCard, 0x42000001, "\x12\x34\x56", 3); Definition at line 2385 of file winscard_clnt.c. References PROFILE_END, PROFILE_START, SCARD_E_INVALID_PARAMETER, and SCardGetSetAttrib(). |
|
Definition at line 560 of file winscard_clnt.c. References SCARD_S_SUCCESS. |
|
This function returns the current status of the reader connected to by hCard. It's friendly name will be stored in szReaderName. pcchReaderLen will be the size of the allocated buffer for szReaderName, while pcbAtrLen will be the size of the allocated buffer for pbAtr. If either of these is too small, the function will return with SCARD_E_INSUFFICIENT_BUFFER and the necessary size in pcchReaderLen and pcbAtrLen. The current state, and protocol will be stored in pdwState and pdwProtocol respectively.
SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol; DWORD dwState, dwProtocol, dwAtrLen, dwReaderLen; BYTE pbAtr[MAX_ATR_SIZE]; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); ... dwAtrLen = sizeof(pbAtr); rv=SCardStatus(hCard, NULL, &dwReaderLen, &dwState, &dwProtocol, pbAtr, &dwAtrLen); Definition at line 1377 of file winscard_clnt.c. References PCSCLITE_MAX_READERS_CONTEXTS, PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_PARAMETER, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
This function sends an APDU to the smart card contained in the reader connected to by SCardConnect(). The card responds from the APDU and stores this response in pbRecvBuffer and it's length in SpcbRecvLength. SSendPci and SRecvPci are structures containing the following: typedef struct { DWORD dwProtocol; // SCARD_PROTOCOL_T0 or SCARD_PROTOCOL_T1 DWORD cbPciLength; // Length of this structure - not used } SCARD_IO_REQUEST;
LONG rv; SCARDCONTEXT hContext; SCARDHANDLE hCard; DWORD dwActiveProtocol, dwSendLength, dwRecvLength; SCARD_IO_REQUEST pioRecvPci; BYTE pbRecvBuffer[10]; BYTE pbSendBuffer[] = { 0xC0, 0xA4, 0x00, 0x00, 0x02, 0x3F, 0x00 }; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol); dwSendLength = sizeof(pbSendBuffer); dwRecvLength = sizeof(pbRecvBuffer); rv = SCardTransmit(hCard, SCARD_PCI_T0, pbSendBuffer, dwSendLength, &pioRecvPci, pbRecvBuffer, &dwRecvLength); Definition at line 2553 of file winscard_clnt.c. References PROFILE_START, psContextMap, readerStates, SCARD_E_INVALID_HANDLE, SCARD_E_INVALID_PARAMETER, SCARD_E_NO_SERVICE, SCARD_S_SUCCESS, SCardCheckDaemonAvailability(), SCardGetIndicesFromHandle(), and SYS_MutexLock(). |
|
free resources allocated by the library You _shall_ call this function if you use dlopen/dlclose to load/unload the library. Otherwise you will exhaust the ressources available. Definition at line 3158 of file winscard_clnt.c. References isExecuted, mapAddr, and SYS_CloseFile(). |
|
This function unlocks a mutex so another thread may use the client.
Wrapper to the function Definition at line 3121 of file winscard_clnt.c. References clientMutex, and SYS_MutexUnLock(). Referenced by SCardBeginTransaction(), SCardCancel(), SCardCancelTransaction(), SCardConnect(), SCardDisconnect(), SCardEndTransaction(), SCardEstablishContext(), SCardGetContextIndice(), SCardGetIndicesFromHandle(), SCardGetStatusChange(), SCardListReaderGroups(), SCardListReaders(), SCardReconnect(), SCardReleaseContext(), SCardStatus(), and SCardTransmit(). |
|
Ensure that some functions be accessed in thread-safe mode. These function's names finishes with "TH". Definition at line 167 of file winscard_clnt.c. Referenced by SCardLockThread(), and SCardUnlockThread(). |
|
Memory mapped address used to read status information about the readers.
Each element in the vector Definition at line 161 of file winscard_clnt.c. Referenced by SCardUnload(). |
|
Represents the an Application Context on the Client side.
An Application Context contains Channels ( Referenced by getSessionForContext(), isActiveContextPresent(), PCSC_SCF_Initialize(), SCardAddContext(), SCardAddHandle(), SCardBeginTransaction(), SCardCancel(), SCardCancelTH(), SCardCancelTransaction(), SCardConnect(), SCardControl(), SCardDisconnect(), SCardEndTransaction(), SCardGetContextIndice(), SCardGetContextIndiceTH(), SCardGetIndicesFromHandleTH(), SCardGetSetAttrib(), SCardGetStatusChange(), SCardListReaderGroups(), SCardListReaders(), SCardReconnect(), SCardReleaseContext(), SCardRemoveContext(), SCardRemoveHandle(), SCardStatus(), and SCardTransmit(). |
|
Pointers to a memory mapped area used to read status information about the readers.
Each element in the vector Definition at line 175 of file winscard_clnt.c. |