HID OMNIKEY Smart Card Readers' Sample Codes  0.0.0.116
HidGlobal.OK.Readers.ISmartCardReader Interface Reference
Inheritance diagram for HidGlobal.OK.Readers.ISmartCardReader:
HidGlobal.OK.Readers.SmartCardReader

Public Member Functions

void Connect (ReaderSharingMode mode, Protocol preferredProtocol)
 Establishes a connection between the calling application and a smart card. More...
 
void ConnectDirect ()
 Establishes a connection between the calling application and a smart card in Direct mode, can be used to send control commands to reader without any smart card present. More...
 
void Reconnect (CardInitialization initialization, ReaderSharingMode mode, Protocol protocol)
 Reestablishes an existing connection from the calling application to the smart card. More...
 
void Disconnect (CardDisposition disposition=CardDisposition.Unpower)
 Terminates a connection between the calling application and a smart card. More...
 
void BeginTransaction ()
 The function waits for the completion of all other transactions before it begins. After the transaction starts, all other applications are blocked from accessing the smart card while the transaction is in progress. More...
 
void EndTransaction (CardDisposition disposition)
 The SCardEndTransaction function completes a previously declared transaction, allowing other applications to resume interactions with the card. More...
 
ConnectionStatus CheckConnectionStatus ()
 State of smart card in the reader. More...
 
IReadOnlyList< byte > Control (ReaderControlCode controlCode, IReadOnlyList< byte > dataBytes)
 Gets direct control of the reader after Connect is called. More...
 
string Control (ReaderControlCode controlCode, string dataBytes)
 Gets direct control of the reader after Connect is called. More...
 
IReadOnlyList< byte > Transmit (IReadOnlyList< byte > apdu)
 Sends a service request to a smart card. More...
 
IReadOnlyList< byte > Transmit (ref IoRequest sendPci, ref IoRequest recivePci, IReadOnlyList< byte > apdu)
 Sends a service request to a smart card. More...
 
string Transmit (string apdu)
 Sends a service request to a smart card. More...
 
string Transmit (ref IoRequest sendPci, ref IoRequest recivePci, string apdu)
 Sends a service request to a smart card. More...
 
IReadOnlyList< byte > GetAttribiute (Attribiutes attribiuteId)
 Gets the current reader's attributes from a given reader, driver, or smart card. More...
 
void SetAttribiute (Attribiutes attribiuteId, IReadOnlyList< byte > attribiute)
 Sets a given reader attribute. More...
 

Properties

string PcscReaderName [get]
 Reader name seen by Windows Smart Card Resource Manager. More...
 
Protocol ActiveProtocol [get]
 Smart card protocol used in current connection. More...
 
ReaderSharingMode ConnectionMode [get]
 Reader share mode used in current connection.s More...
 
bool IsConnected [get]
 Connection status. More...
 

Member Function Documentation

◆ BeginTransaction()

void HidGlobal.OK.Readers.ISmartCardReader.BeginTransaction ( )

The function waits for the completion of all other transactions before it begins. After the transaction starts, all other applications are blocked from accessing the smart card while the transaction is in progress.

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ CheckConnectionStatus()

ConnectionStatus HidGlobal.OK.Readers.ISmartCardReader.CheckConnectionStatus ( )

State of smart card in the reader.

Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Connect()

void HidGlobal.OK.Readers.ISmartCardReader.Connect ( ReaderSharingMode  mode,
Protocol  preferredProtocol 
)

Establishes a connection between the calling application and a smart card.

Parameters
modeReader share mode to be used in current connection.
preferredProtocolSmart card protocol to be used in current connection.

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ ConnectDirect()

void HidGlobal.OK.Readers.ISmartCardReader.ConnectDirect ( )

Establishes a connection between the calling application and a smart card in Direct mode, can be used to send control commands to reader without any smart card present.

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Control() [1/2]

IReadOnlyList<byte> HidGlobal.OK.Readers.ISmartCardReader.Control ( ReaderControlCode  controlCode,
IReadOnlyList< byte >  dataBytes 
)

Gets direct control of the reader after Connect is called.

Parameters
controlCode
dataBytes
Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Control() [2/2]

string HidGlobal.OK.Readers.ISmartCardReader.Control ( ReaderControlCode  controlCode,
string  dataBytes 
)

Gets direct control of the reader after Connect is called.

Parameters
controlCode
dataBytes
Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Disconnect()

void HidGlobal.OK.Readers.ISmartCardReader.Disconnect ( CardDisposition  disposition = CardDisposition.Unpower)

Terminates a connection between the calling application and a smart card.

Parameters
dispositionAction to take on the card in the connected reader on close.

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ EndTransaction()

void HidGlobal.OK.Readers.ISmartCardReader.EndTransaction ( CardDisposition  disposition)

The SCardEndTransaction function completes a previously declared transaction, allowing other applications to resume interactions with the card.

Parameters
dispositionAction to take on the card in the connected reader on close.

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ GetAttribiute()

IReadOnlyList<byte> HidGlobal.OK.Readers.ISmartCardReader.GetAttribiute ( Attribiutes  attribiuteId)

Gets the current reader's attributes from a given reader, driver, or smart card.

Parameters
attribiuteIdIdentifier for the attribute to get.
Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Reconnect()

void HidGlobal.OK.Readers.ISmartCardReader.Reconnect ( CardInitialization  initialization,
ReaderSharingMode  mode,
Protocol  protocol 
)

Reestablishes an existing connection from the calling application to the smart card.

Parameters
initializationType of initialization that should be performed on the card.
modeReader share mode to be used in current connection.
protocolSmart card protocol to be used in current connection.

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ SetAttribiute()

void HidGlobal.OK.Readers.ISmartCardReader.SetAttribiute ( Attribiutes  attribiuteId,
IReadOnlyList< byte >  attribiute 
)

Sets a given reader attribute.

Parameters
attribiuteIdIdentifier for the attribute to set.
attribiute
Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Transmit() [1/4]

IReadOnlyList<byte> HidGlobal.OK.Readers.ISmartCardReader.Transmit ( IReadOnlyList< byte >  apdu)

Sends a service request to a smart card.

Parameters
apdu
Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Transmit() [2/4]

IReadOnlyList<byte> HidGlobal.OK.Readers.ISmartCardReader.Transmit ( ref IoRequest  sendPci,
ref IoRequest  recivePci,
IReadOnlyList< byte >  apdu 
)

Sends a service request to a smart card.

Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Transmit() [3/4]

string HidGlobal.OK.Readers.ISmartCardReader.Transmit ( string  apdu)

Sends a service request to a smart card.

Parameters
apdu
Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

◆ Transmit() [4/4]

string HidGlobal.OK.Readers.ISmartCardReader.Transmit ( ref IoRequest  sendPci,
ref IoRequest  recivePci,
string  apdu 
)

Sends a service request to a smart card.

Returns

Implemented in HidGlobal.OK.Readers.SmartCardReader.

Property Documentation

◆ ActiveProtocol

Protocol HidGlobal.OK.Readers.ISmartCardReader.ActiveProtocol
get

Smart card protocol used in current connection.

◆ ConnectionMode

ReaderSharingMode HidGlobal.OK.Readers.ISmartCardReader.ConnectionMode
get

Reader share mode used in current connection.s

◆ IsConnected

bool HidGlobal.OK.Readers.ISmartCardReader.IsConnected
get

Connection status.

◆ PcscReaderName

string HidGlobal.OK.Readers.ISmartCardReader.PcscReaderName
get

Reader name seen by Windows Smart Card Resource Manager.


The documentation for this interface was generated from the following file: