Module com.itemis.jscdlib

Package com.itemis.jscdlib.internal

Class ScardLibNativeBridge

java.lang.Object

com.itemis.jscdlib.internal.NativeBase

com.itemis.jscdlib.internal.ScardLibNativeBridge

All Implemented Interfaces:

AutoCloseable

public final class ScardLibNativeBridge
extends NativeBase
implements AutoCloseable

ScardLibNativeBridge relies on preview features of the Java platform:

• ScardLibNativeBridge refers to one or more preview APIs: Arena, MemorySegment, SymbolLookup.

Programs can only use ScardLibNativeBridge when preview features are enabled.

Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.

Constructor Summary

Constructors

Constructor	Description
ScardLibNativeBridge(Function<ArenaPREVIEW,SymbolLookupPREVIEW> libSup)	Create a new instance.

Method Summary

Modifier and Type	Method	Description
void	close()
long	sCardEstablishContext(long dwScope, MemorySegmentPREVIEW pvReserved1, MemorySegmentPREVIEW pvReserved2, MemorySegmentPREVIEW phContext)	See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardestablishcontext
long	sCardFreeMemory(MemorySegmentPREVIEW hContext, MemorySegmentPREVIEW pvMem)	See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardfreememory
long	sCardListReaders(MemorySegmentPREVIEW hContext, MemorySegmentPREVIEW mszGroups, MemorySegmentPREVIEW mszReaders, MemorySegmentPREVIEW pcchReaders)	See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardlistreadersa
long	sCardReleaseContext(MemorySegmentPREVIEW hContext)	See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardreleasecontext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ScardLibNativeBridge

public ScardLibNativeBridge(Function<ArenaPREVIEW,SymbolLookupPREVIEW> libSup)

Create a new instance.

Parameters:

libSup - - Creates a "Connection" to the underlying native library in form of a SymbolLookup^PREVIEW. The connection will be closed when close() is called.

Method Details

sCardEstablishContext

public long sCardEstablishContext(long dwScope,
 MemorySegmentPREVIEW pvReserved1,
 MemorySegmentPREVIEW pvReserved2,
 MemorySegmentPREVIEW phContext)

See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardestablishcontext

Parameters:

dwScope - -

invalid reference

#PCSC_SCOPE_SYSTEM

or

invalid reference

#PCSC_SCOPE_USER

.

pvReserved1 - - Reserved for future use and must be MemorySegment.NULL^PREVIEW

pvReserved2 - - Reserved for future use and must be MemorySegment.NULL^PREVIEW.

phContext -

Returns:

invalid reference

#SCARD_S_SUCCESS

if success, else error code according to SmartCard return values.

sCardListReaders

public long sCardListReaders(MemorySegmentPREVIEW hContext,
 MemorySegmentPREVIEW mszGroups,
 MemorySegmentPREVIEW mszReaders,
 MemorySegmentPREVIEW pcchReaders)

See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardlistreadersa

Parameters:

hContext -

mszGroups -

mszReaders -

pcchReaders -

Returns:

invalid reference

#SCARD_S_SUCCESS

if success, else error code according to SmartCard return values.

sCardFreeMemory

public long sCardFreeMemory(MemorySegmentPREVIEW hContext,
 MemorySegmentPREVIEW pvMem)

See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardfreememory

Parameters:

hContext -

pvMem - - Memory block to be released.

Returns:

invalid reference

#SCARD_S_SUCCESS

if success, else error code according to SmartCard return values.

sCardReleaseContext

public long sCardReleaseContext(MemorySegmentPREVIEW hContext)

See https://docs.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardreleasecontext

Parameters:

hContext -

Returns:

invalid reference

#SCARD_S_SUCCESS

if success, else error code according to SmartCard return values.

close

public void close()

Specified by:

close in interface AutoCloseable