net.sf.crypton.scard.pcsclite

Interface PcscliteLibrary

All Superinterfaces:

com.sun.jna.Library

public interface PcscliteLibrary
extends com.sun.jna.Library

JNA Wrapper for library pcsclite
For documentation on pcsc standard see ://pcsclite.alioth.debian.org/doxygen/html/group__API.html TODO: improve javadocs TODO: structures as top level classes

Nested Class Summary

Nested classes/interfaces inherited from interface com.sun.jna.Library

com.sun.jna.Library.Handler

Field Summary

Fields

Modifier and Type	Field and Description
static String	JNA_LIBRARY_NAME

Fields inherited from interface com.sun.jna.Library

OPTION_ALLOW_OBJECTS, OPTION_CALLING_CONVENTION, OPTION_FUNCTION_MAPPER, OPTION_INVOCATION_MAPPER, OPTION_OPEN_FLAGS, OPTION_STRUCTURE_ALIGNMENT, OPTION_TYPE_MAPPER

Method Summary

Methods

Modifier and Type	Method and Description
String	pcsc_stringify_error(com.sun.jna.NativeLong c1) Gets a stringified error response Original signature : char* pcsc_stringify_error(const long) native declaration : /usr/include/PCSC/wintypes.h:189
com.sun.jna.NativeLong	SCardBeginTransaction(com.sun.jna.NativeLong hCard) Establishes a temporary exclusive access mode for doing a serie of commands in a transaction.
com.sun.jna.NativeLong	SCardCancel(com.sun.jna.NativeLong hContext) Original signature : LONG SCardCancel(SCARDCONTEXT) native declaration : /usr/include/PCSC/wintypes.h:254
com.sun.jna.NativeLong	SCardCancelTransaction(com.sun.jna.NativeLong hCard) Original signature : LONG SCardCancelTransaction(SCARDHANDLE) native declaration : /usr/include/PCSC/wintypes.h:219
com.sun.jna.NativeLong	SCardConnect(com.sun.jna.NativeLong hContext, com.sun.jna.Pointer szReader, int dwShareMode, int dwPreferredProtocols, com.sun.jna.ptr.LongByReference phCard, com.sun.jna.ptr.IntByReference pdwActiveProtocol) Deprecated.
com.sun.jna.NativeLong	SCardConnect(com.sun.jna.NativeLong hContext, String szReader, int dwShareMode, int dwPreferredProtocols, com.sun.jna.ptr.LongByReference phCard, IntBuffer pdwActiveProtocol)
com.sun.jna.NativeLong	SCardControl(com.sun.jna.NativeLong hCard, int dwControlCode, com.sun.jna.Pointer pbSendBuffer, int cbSendLength, com.sun.jna.Pointer pbRecvBuffer, int cbRecvLength, IntBuffer lpBytesReturned)
com.sun.jna.NativeLong	SCardControl(com.sun.jna.NativeLong hCard, int dwControlCode, com.sun.jna.Pointer pbSendBuffer, int cbSendLength, com.sun.jna.Pointer pbRecvBuffer, int cbRecvLength, com.sun.jna.ptr.IntByReference lpBytesReturned) Deprecated.
com.sun.jna.NativeLong	SCardDisconnect(com.sun.jna.NativeLong hCard, int dwDisposition) Original signature : LONG SCardDisconnect(SCARDHANDLE, DWORD) native declaration : /usr/include/PCSC/wintypes.h:213
com.sun.jna.NativeLong	SCardEndTransaction(com.sun.jna.NativeLong hCard, int dwDisposition) Original signature : LONG SCardEndTransaction(SCARDHANDLE, DWORD) native declaration : /usr/include/PCSC/wintypes.h:217
com.sun.jna.NativeLong	SCardEstablishContext(int dwScope, com.sun.jna.Pointer pvReserved1, com.sun.jna.Pointer pvReserved2, com.sun.jna.ptr.NativeLongByReference phContext) Original signature: LONG SCardEstablishContext(DWORD dwScope, (null) LPCVOID pvReserved1, (null) LPCVOID pvReserved2, (out) LPSCARDCONTEXT phContext);
com.sun.jna.NativeLong	SCardFreeMemory(com.sun.jna.NativeLong hContext, com.sun.jna.Pointer pvMem)
com.sun.jna.NativeLong	SCardGetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, byte[] pbAttr, com.sun.jna.ptr.IntByReference pcchReaders) Deprecated.
com.sun.jna.NativeLong	sCardGetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, ByteBuffer pbAttr, IntBuffer pcbAttrLen) native declaration : /usr/include/PCSC/wintypes.h:256 Conversion Error : LPBYTE PCSC_API LONG SCardGetAttrib(SCARDHANDLE hCard, DWORD dwAttrId,
com.sun.jna.NativeLong	SCardGetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, ByteBuffer pbAttr, IntBuffer pcbAttrLen)
com.sun.jna.NativeLong	SCardGetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, com.sun.jna.Pointer pbAttr, com.sun.jna.ptr.IntByReference pcbAttrLen) Deprecated.
com.sun.jna.NativeLong	SCardGetStatusChange(com.sun.jna.NativeLong hContext, int dwTimeout, SCARD_READERSTATE_A rgReaderStates, int cReaders) Blocks execution until the current availability of the cards in a specific set of readers changes.
com.sun.jna.NativeLong	SCardIsValidContext(com.sun.jna.NativeLong hContext) Original signature : LONG SCardIsValidContext(SCARDCONTEXT) native declaration : /usr/include/PCSC/wintypes.h:198
com.sun.jna.NativeLong	SCardListReaderGroups(com.sun.jna.NativeLong hContext, Buffer mszGroups, IntBuffer pcchGroups) Returns a list of currently available reader groups on the system.
com.sun.jna.NativeLong	SCardListReaders(com.sun.jna.NativeLong hContext, Buffer mszGroups, Buffer mszReaders, IntBuffer pcchReaders) PCSC_API LONG SCardListReaders(SCARDCONTEXT hContext, (null out) LPCSTR mszGroups, (null out) LPSTR mszReaders, (out) LPDWORD pcchReaders); Original translated as: NativeLong SCardListReaders(NativeLong hContext, String mszGroups, String mszReaders, IntBuffer pcchReaders);
com.sun.jna.NativeLong	SCardListReaders(com.sun.jna.NativeLong hContext, com.sun.jna.Pointer mszGroups, com.sun.jna.Pointer mszReaders, com.sun.jna.ptr.IntByReference pcchReaders) Deprecated.
com.sun.jna.NativeLong	SCardReconnect(com.sun.jna.NativeLong hCard, int dwShareMode, int dwPreferredProtocols, int dwInitialization, IntBuffer pdwActiveProtocol)
com.sun.jna.NativeLong	SCardReconnect(com.sun.jna.NativeLong hCard, int dwShareMode, int dwPreferredProtocols, int dwInitialization, com.sun.jna.ptr.IntByReference pdwActiveProtocol) Deprecated.
com.sun.jna.NativeLong	SCardReleaseContext(com.sun.jna.NativeLong hContext) Original signature : LONG SCardReleaseContext(SCARDCONTEXT) native declaration : /usr/include/PCSC/wintypes.h:196
com.sun.jna.NativeLong	sCardSetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, byte[] pbAttr, int cbAttrLen) native declaration : /usr/include/PCSC/wintypes.h:259 Conversion Error : LPCBYTE PCSC_API LONG SCardSetAttrib(SCARDHANDLE hCard, DWORD dwAttrId, LPCBYTE pbAttr, DWORD cbAttrLen);
com.sun.jna.NativeLong	SCardSetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, byte[] pbAttr, int cbAttrLen)
com.sun.jna.NativeLong	sCardSetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, com.sun.jna.Pointer pbAttr, int cbAttrLen) Deprecated.
com.sun.jna.NativeLong	SCardSetAttrib(com.sun.jna.NativeLong hCard, int dwAttrId, com.sun.jna.Pointer pbAttr, int cbAttrLen) Deprecated.
com.sun.jna.NativeLong	SCardSetTimeout(com.sun.jna.NativeLong hContext, int dwTimeout) Original signature : LONG SCardSetTimeout(SCARDCONTEXT, DWORD) native declaration : /usr/include/PCSC/wintypes.h:200
com.sun.jna.NativeLong	SCardStatus(com.sun.jna.NativeLong hCard, com.sun.jna.Pointer mszReaderName, com.sun.jna.ptr.IntByReference pcchReaderLen, com.sun.jna.ptr.IntByReference pdwState, com.sun.jna.ptr.IntByReference pdwProtocol, com.sun.jna.Pointer pbAtr, com.sun.jna.ptr.IntByReference pcbAtrLen) Deprecated.
com.sun.jna.NativeLong	SCardStatus(com.sun.jna.NativeLong hCard, String mszReaderName, IntBuffer pcchReaderLen, IntBuffer pdwState, IntBuffer pdwProtocol, ByteBuffer pbAtr, IntBuffer pcbAtrLen)
com.sun.jna.NativeLong	SCardTransmit(com.sun.jna.NativeLong hCard, SCARD_IO_REQUEST pioSendPci, byte[] pbSendBuffer, int cbSendLength, LPSCARD_IO_REQUEST_struct pioRecvPci, ByteBuffer pbRecvBuffer, IntBuffer pcbRecvLength)
com.sun.jna.NativeLong	SCardTransmit(com.sun.jna.NativeLong hCard, SCARD_IO_REQUEST pioSendPci, com.sun.jna.Pointer pbSendBuffer, int cbSendLength, LPSCARD_IO_REQUEST_struct pioRecvPci, com.sun.jna.Pointer pbRecvBuffer, com.sun.jna.ptr.IntByReference pcbRecvLength) Deprecated.

Field Detail

JNA_LIBRARY_NAME

static final String JNA_LIBRARY_NAME

See Also:

Constant Field Values

Method Detail

pcsc_stringify_error

String pcsc_stringify_error(com.sun.jna.NativeLong c1)

Gets a stringified error response
Original signature : char* pcsc_stringify_error(const long)
native declaration : /usr/include/PCSC/wintypes.h:189

SCardBeginTransaction

com.sun.jna.NativeLong SCardBeginTransaction(com.sun.jna.NativeLong hCard)

Establishes a temporary exclusive access mode for doing a serie of commands in a 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 SCARD_SHARE_EXCLUSIVE there will be no action taken.

 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 * /
 
 

Parameters:

hCard - Connection made from SCardConnect().

Returns:

Error code. Return values:

• SCARD_S_SUCCESS Successful.
• SCARD_E_INVALID_HANDLE Invalid hCard handle.
• SCARD_E_NO_SERVICE The server is not running.
• SCARD_E_READER_UNAVAILABLE The reader has been removed.
• SCARD_E_SHARING_VIOLATION Someone else has exclusive rights.
• SCARD_F_COMM_ERROR An internal communications error has been detected.

SCardCancel

com.sun.jna.NativeLong SCardCancel(com.sun.jna.NativeLong hContext)

Original signature : LONG SCardCancel(SCARDCONTEXT)
native declaration : /usr/include/PCSC/wintypes.h:254

SCardCancelTransaction

com.sun.jna.NativeLong SCardCancelTransaction(com.sun.jna.NativeLong hCard)

Original signature : LONG SCardCancelTransaction(SCARDHANDLE)
native declaration : /usr/include/PCSC/wintypes.h:219

SCardDisconnect

com.sun.jna.NativeLong SCardDisconnect(com.sun.jna.NativeLong hCard,
                                     int dwDisposition)

Original signature : LONG SCardDisconnect(SCARDHANDLE, DWORD)
native declaration : /usr/include/PCSC/wintypes.h:213

SCardEndTransaction

com.sun.jna.NativeLong SCardEndTransaction(com.sun.jna.NativeLong hCard,
                                         int dwDisposition)

Original signature : LONG SCardEndTransaction(SCARDHANDLE, DWORD)
native declaration : /usr/include/PCSC/wintypes.h:217

SCardEstablishContext

com.sun.jna.NativeLong SCardEstablishContext(int dwScope,
                                           com.sun.jna.Pointer pvReserved1,
                                           com.sun.jna.Pointer pvReserved2,
                                           com.sun.jna.ptr.NativeLongByReference phContext)

Original signature: LONG SCardEstablishContext(DWORD dwScope, (null) LPCVOID pvReserved1, (null) LPCVOID pvReserved2, (out) LPSCARDCONTEXT phContext);

Creates an Application Context to the PC/SC Resource Manager.

This must be the first WinSCard function called in a PC/SC application. Each thread of an application shall use its own SCARDCONTEXT.

Parameters:

dwScope - Scope of the establishment. This can either be a local or remote connection.

• SCARD_SCOPE_USER - Not used.
• SCARD_SCOPE_TERMINAL - Not used.
• SCARD_SCOPE_GLOBAL - Not used.
• SCARD_SCOPE_SYSTEM - Services on the local machine.

pvReserved1 - Reserved for future use.

pvReserved2 - Reserved for future use.

phContext - Returned Application Context.

Returns:

Error code. Return values:

• SCARD_S_SUCCESS Successful (SCARD_S_SUCCESS)
• SCARD_E_INVALID_PARAMETER phContext is null (SCARD_E_INVALID_PARAMETER)
• SCARD_E_INVALID_VALUE Invalid scope type passed (SCARD_E_INVALID_VALUE )
• SCARD_E_NO_MEMORY There is no free slot to store hContext (SCARD_E_NO_MEMORY)
• SCARD_E_NO_SERVICE The server is not running (SCARD_E_NO_SERVICE)
• SCARD_F_COMM_ERROR An internal communications error has been detected (SCARD_F_COMM_ERROR)
• SCARD_F_INTERNAL_ERROR An internal consistency check failed (SCARD_F_INTERNAL_ERROR)

SCardGetStatusChange

com.sun.jna.NativeLong SCardGetStatusChange(com.sun.jna.NativeLong hContext,
                                          int dwTimeout,
                                          SCARD_READERSTATE_A rgReaderStates,
                                          int cReaders)

Blocks execution until the current availability of the cards in a specific set of readers changes. This function receives a structure or list of structures containing reader names. It then blocks waiting for a change in state to occur 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. dwEventState also contains a number of events in the upper 16 bits (dwEventState & 0xFFFF0000). This number of events is incremented for each card insertion or removal in the specified reader. This can be used to detect a card removal/insertion between two calls to SCardGetStatusChange() To wait for a reader event (reader added or removed) you may use the special reader name "\\?PnP?\Notification". If a reader event occurs the state of this reader will change and the bit SCARD_STATE_CHANGED will be set. typedef struct { LPCSTR 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, *LPSCARD_READERSTATE; Value of dwCurrentState and dwEventState: SCARD_STATE_UNAWARE The application is unaware of the current state, and would like to know. The use of this value results in an immediate return from state transition monitoring services. This is represented by all bits set to zero. SCARD_STATE_IGNORE This reader should be ignored SCARD_STATE_CHANGED There is a difference between the state believed by the application, and the state known by the resource manager. When this bit is set, the application may assume a significant state change has occurred on this reader. SCARD_STATE_UNKNOWN The given reader name is not recognized by the resource manager. If this bit is set, then SCARD_STATE_CHANGED and SCARD_STATE_IGNORE will also be set SCARD_STATE_UNAVAILABLE The actual state of this reader is not available. If this bit is set, then all the following bits are clear. SCARD_STATE_EMPTY There is no card in the reader. If this bit is set, all the following bits will be clear SCARD_STATE_PRESENT There is a card in the reader SCARD_STATE_EXCLUSIVE The card in the reader is allocated for exclusive use by another application. If this bit is set, SCARD_STATE_PRESENT will also be set. SCARD_STATE_INUSE The card in the reader is in use by one or more other applications, but may be connected to in shared mode. If this bit is set, SCARD_STATE_PRESENT will also be set. SCARD_STATE_MUTE There is an unresponsive card in the reader. Parameters: [in] hContext Connection context to the PC/SC Resource Manager. [in] dwTimeout Maximum waiting time (in milliseconds) for status change, zero (or INFINITE) for infinite. [in,out] rgReaderStates Structures of readers with current states. [in] cReaders Number of structures. Returns: Error code. Return values: SCARD_S_SUCCESS Successful (SCARD_S_SUCCESS) SCARD_E_NO_SERVICE Server is not running (SCARD_E_NO_SERVICE) SCARD_E_INVALID_PARAMETER rgReaderStates is NULL and cReaders > 0 (SCARD_E_INVALID_PARAMETER) SCARD_E_INVALID_VALUE Invalid States, reader name, etc (SCARD_E_INVALID_VALUE) SCARD_E_INVALID_HANDLE Invalid hContext handle (SCARD_E_INVALID_HANDLE) SCARD_E_READER_UNAVAILABLE The reader is unavailable (SCARD_E_READER_UNAVAILABLE) SCARD_E_TIMEOUT The user-specified timeout value has expired (SCARD_E_TIMEOUT) SCARDCONTEXT hContext; SCARD_READERSTATE rgReaderStates[2]; LONG rv; ... rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); ... rgReaderStates[0].szReader = "Reader X"; rgReaderStates[0].dwCurrentState = SCARD_STATE_UNAWARE; rgReaderStates[1].szReader = "\\\\?PnP?\\Notification"; rgReaderStates[1].dwCurrentState = SCARD_STATE_UNAWARE; ... rv = SCardGetStatusChange(hContext, INFINITE, rgReaderStates, 2); printf("reader state: 0x%04X\n", rgReaderStates[0].dwEventState); printf("reader state: 0x%04X\n", rgReaderStates[1].dwEventState); Original signature : LONG SCardGetStatusChange(SCARDCONTEXT, DWORD, LPSCARD_READERSTATE_A, DWORD)
native declaration : /usr/include/PCSC/wintypes.h:229

SCardIsValidContext

com.sun.jna.NativeLong SCardIsValidContext(com.sun.jna.NativeLong hContext)

Original signature : LONG SCardIsValidContext(SCARDCONTEXT)
native declaration : /usr/include/PCSC/wintypes.h:198

SCardListReaders

@Deprecated
com.sun.jna.NativeLong SCardListReaders(com.sun.jna.NativeLong hContext,
                                                 com.sun.jna.Pointer mszGroups,
                                                 com.sun.jna.Pointer mszReaders,
                                                 com.sun.jna.ptr.IntByReference pcchReaders)

Deprecated.

See Also:

#sCardListReaders(NativeLong hContext, String mszGroups, String mszReaders, IntBuffer pcchReaders)

SCardListReaders

com.sun.jna.NativeLong SCardListReaders(com.sun.jna.NativeLong hContext,
                                      Buffer mszGroups,
                                      Buffer mszReaders,
                                      IntBuffer pcchReaders)

PCSC_API LONG SCardListReaders(SCARDCONTEXT hContext, (null out) LPCSTR mszGroups, (null out) LPSTR mszReaders, (out) LPDWORD pcchReaders); Original translated as: NativeLong SCardListReaders(NativeLong hContext, String mszGroups, String mszReaders, IntBuffer pcchReaders);

SCardReleaseContext

com.sun.jna.NativeLong SCardReleaseContext(com.sun.jna.NativeLong hContext)

Original signature : LONG SCardReleaseContext(SCARDCONTEXT)
native declaration : /usr/include/PCSC/wintypes.h:196

SCardSetTimeout

com.sun.jna.NativeLong SCardSetTimeout(com.sun.jna.NativeLong hContext,
                                     int dwTimeout)

Original signature : LONG SCardSetTimeout(SCARDCONTEXT, DWORD)
native declaration : /usr/include/PCSC/wintypes.h:200

sCardGetAttrib

com.sun.jna.NativeLong sCardGetAttrib(com.sun.jna.NativeLong hCard,
                                    int dwAttrId,
                                    ByteBuffer pbAttr,
                                    IntBuffer pcbAttrLen)

native declaration : /usr/include/PCSC/wintypes.h:256
Conversion Error : LPBYTE PCSC_API LONG SCardGetAttrib(SCARDHANDLE hCard, DWORD dwAttrId,

SCardGetAttrib

@Deprecated
com.sun.jna.NativeLong SCardGetAttrib(com.sun.jna.NativeLong hCard,
                                               int dwAttrId,
                                               byte[] pbAttr,
                                               com.sun.jna.ptr.IntByReference pcchReaders)

Deprecated.

See Also:

sCardGetAttrib(NativeLong hCard, int dwAttrId, ByteBuffer pbAttr, IntBuffer pcbAttrLen)

sCardSetAttrib

@Deprecated
com.sun.jna.NativeLong sCardSetAttrib(com.sun.jna.NativeLong hCard,
                                               int dwAttrId,
                                               com.sun.jna.Pointer pbAttr,
                                               int cbAttrLen)

Deprecated.

sCardSetAttrib

com.sun.jna.NativeLong sCardSetAttrib(com.sun.jna.NativeLong hCard,
                                    int dwAttrId,
                                    byte[] pbAttr,
                                    int cbAttrLen)

native declaration : /usr/include/PCSC/wintypes.h:259
Conversion Error : LPCBYTE PCSC_API LONG SCardSetAttrib(SCARDHANDLE hCard, DWORD dwAttrId, LPCBYTE pbAttr, DWORD cbAttrLen);

SCardConnect

@Deprecated
com.sun.jna.NativeLong SCardConnect(com.sun.jna.NativeLong hContext,
                                             com.sun.jna.Pointer szReader,
                                             int dwShareMode,
                                             int dwPreferredProtocols,
                                             com.sun.jna.ptr.LongByReference phCard,
                                             com.sun.jna.ptr.IntByReference pdwActiveProtocol)

Deprecated.

See Also:

SCardConnect(NativeLong hContext, String szReader, int dwShareMode, int dwPreferredProtocols, LongByReference phCard, IntBuffer pdwActiveProtocol)

SCardConnect

com.sun.jna.NativeLong SCardConnect(com.sun.jna.NativeLong hContext,
                                  String szReader,
                                  int dwShareMode,
                                  int dwPreferredProtocols,
                                  com.sun.jna.ptr.LongByReference phCard,
                                  IntBuffer pdwActiveProtocol)

SCardReconnect

@Deprecated
com.sun.jna.NativeLong SCardReconnect(com.sun.jna.NativeLong hCard,
                                               int dwShareMode,
                                               int dwPreferredProtocols,
                                               int dwInitialization,
                                               com.sun.jna.ptr.IntByReference pdwActiveProtocol)

Deprecated.

SCardReconnect

com.sun.jna.NativeLong SCardReconnect(com.sun.jna.NativeLong hCard,
                                    int dwShareMode,
                                    int dwPreferredProtocols,
                                    int dwInitialization,
                                    IntBuffer pdwActiveProtocol)

SCardStatus

@Deprecated
com.sun.jna.NativeLong SCardStatus(com.sun.jna.NativeLong hCard,
                                            com.sun.jna.Pointer mszReaderName,
                                            com.sun.jna.ptr.IntByReference pcchReaderLen,
                                            com.sun.jna.ptr.IntByReference pdwState,
                                            com.sun.jna.ptr.IntByReference pdwProtocol,
                                            com.sun.jna.Pointer pbAtr,
                                            com.sun.jna.ptr.IntByReference pcbAtrLen)

Deprecated.

SCardStatus

com.sun.jna.NativeLong SCardStatus(com.sun.jna.NativeLong hCard,
                                 String mszReaderName,
                                 IntBuffer pcchReaderLen,
                                 IntBuffer pdwState,
                                 IntBuffer pdwProtocol,
                                 ByteBuffer pbAtr,
                                 IntBuffer pcbAtrLen)

SCardControl

@Deprecated
com.sun.jna.NativeLong SCardControl(com.sun.jna.NativeLong hCard,
                                             int dwControlCode,
                                             com.sun.jna.Pointer pbSendBuffer,
                                             int cbSendLength,
                                             com.sun.jna.Pointer pbRecvBuffer,
                                             int cbRecvLength,
                                             com.sun.jna.ptr.IntByReference lpBytesReturned)

Deprecated.

SCardControl

com.sun.jna.NativeLong SCardControl(com.sun.jna.NativeLong hCard,
                                  int dwControlCode,
                                  com.sun.jna.Pointer pbSendBuffer,
                                  int cbSendLength,
                                  com.sun.jna.Pointer pbRecvBuffer,
                                  int cbRecvLength,
                                  IntBuffer lpBytesReturned)

SCardTransmit

@Deprecated
com.sun.jna.NativeLong SCardTransmit(com.sun.jna.NativeLong hCard,
                                              SCARD_IO_REQUEST pioSendPci,
                                              com.sun.jna.Pointer pbSendBuffer,
                                              int cbSendLength,
                                              LPSCARD_IO_REQUEST_struct pioRecvPci,
                                              com.sun.jna.Pointer pbRecvBuffer,
                                              com.sun.jna.ptr.IntByReference pcbRecvLength)

Deprecated.

SCardTransmit

com.sun.jna.NativeLong SCardTransmit(com.sun.jna.NativeLong hCard,
                                   SCARD_IO_REQUEST pioSendPci,
                                   byte[] pbSendBuffer,
                                   int cbSendLength,
                                   LPSCARD_IO_REQUEST_struct pioRecvPci,
                                   ByteBuffer pbRecvBuffer,
                                   IntBuffer pcbRecvLength)

SCardListReaderGroups

com.sun.jna.NativeLong SCardListReaderGroups(com.sun.jna.NativeLong hContext,
                                           Buffer mszGroups,
                                           IntBuffer pcchGroups)

Returns a list of currently available reader groups on the system.

mszGroups is a pointer to a character string that is allocated by the application. If the application sends mszGroups as NULL then this function will return the size of the buffer needed to allocate in pcchGroups.

The group names is a multi-string and separated by a null character ('\0') and ended by a double null character like "SCard$DefaultReaders\0Group 2\0\0".

If *pcchGroups is equal to SCARD_AUTOALLOCATE then the function will allocate itself the needed memory. Use SCardFreeMemory() to release it.

 SCARDCONTEXT hContext;
    LPSTR mszGroups;
    DWORD dwGroups;
    LONG rv;
    ...
    rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext);
    rv = SCardListReaderGroups(hContext, NULL, &dwGroups);
    mszGroups = malloc(sizeof(char)*dwGroups);
    rv = SCardListReaderGroups(hContext, mszGroups, &dwGroups);
    
 

    SCARDCONTEXT hContext;
    LPSTR mszGroups;
    DWORD dwGroups;
    LONG rv;
    ...
    rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext);
    dwGroups = SCARD_AUTOALLOCATE;
    rv = SCardListReaderGroups(hContext, (LPSTR)&mszGroups, &dwGroups);
    rv = SCardFreeMemory(hContext, mszGroups);
 

Definition at line 3066 of file winscard_clnt.c.

Parameters:

hContext - Connection context to the PC/SC Resource Manager.

mszGroups - [out]List of groups to list readers.

pcchGroups - [in,out] Size of multi-string buffer including NULL's.

Returns:

Error code:

• SCARD_S_SUCCESS Successful
• SCARD_E_INSUFFICIENT_BUFFER Reader buffer not large enough
• SCARD_E_INVALID_HANDLE Invalid Scope Handle
• SCARD_E_INVALID_PARAMETER mszGroups is NULL
• SCARD_E_NO_MEMORY Memory allocation failed
• SCARD_E_NO_SERVICE The server is not running

See Also:

SCARD_AUTOALLOCATE , PcscLiteConstants#SCARD_E_INSUFFICIENT_BUFFER SCARD_E_INSUFFICIENT_BUFFER , PcscLiteConstants#SCARD_E_INVALID_HANDLE SCARD_E_INVALID_HANDLE , PcscLiteConstants#SCARD_E_INVALID_PARAMETER SCARD_E_INVALID_PARAMETER , PcscLiteConstants#SCARD_E_NO_MEMORY SCARD_E_NO_MEMORY , PcscLiteConstants#SCARD_S_SUCCESS SCARD_S_SUCCESS, #SCardGetContext(). Original signature: NativeLong SCardListReaderGroups(NativeLong hContext, String mszGroups, IntBuffer pcchGroups);

SCardFreeMemory

com.sun.jna.NativeLong SCardFreeMemory(com.sun.jna.NativeLong hContext,
                                     com.sun.jna.Pointer pvMem)

SCardGetAttrib

@Deprecated
com.sun.jna.NativeLong SCardGetAttrib(com.sun.jna.NativeLong hCard,
                                               int dwAttrId,
                                               com.sun.jna.Pointer pbAttr,
                                               com.sun.jna.ptr.IntByReference pcbAttrLen)

Deprecated.

SCardGetAttrib

com.sun.jna.NativeLong SCardGetAttrib(com.sun.jna.NativeLong hCard,
                                    int dwAttrId,
                                    ByteBuffer pbAttr,
                                    IntBuffer pcbAttrLen)

SCardSetAttrib

@Deprecated
com.sun.jna.NativeLong SCardSetAttrib(com.sun.jna.NativeLong hCard,
                                               int dwAttrId,
                                               com.sun.jna.Pointer pbAttr,
                                               int cbAttrLen)

Deprecated.

SCardSetAttrib

com.sun.jna.NativeLong SCardSetAttrib(com.sun.jna.NativeLong hCard,
                                    int dwAttrId,
                                    byte[] pbAttr,
                                    int cbAttrLen)