IFDHCreateChannelByName(3SSmartcard LibraryIFDHCreateChannelByName(3SMARTCARD)NAMEIFDHCreateChannelByName - create a communication channel with an IFD
SYNOPSIS
#include <smartcard/ifdhandler.h>
RESPONSECODE IFDHCreateChannelByName(DWORD Lun, LPSTR devicename);
PARAMETERS
The IFDHCreateChannelByName() function takes the following parameters:
Input
Lun Logical Unit Number
devicename Device name path
DESCRIPTION
The IFDHCreateChannelByName() function opens a communication channel
with a card terminal specified by devicename. This function can use
open(2) or other system call to open the device and establish a commu‐
nication path. The caller of this function (smart card framework)
assigns a logical unit number Lun per card terminal and slot and passes
this value to IFDHCreateChannelByName(). If the IFD handler supports
multiple terminals with one instance of the handler (as indicated by
capability TAG_IFD_SIMULTANEOUS_ACCESS), it communicates with the card
terminal corresponding to this Lun.
If the IFD handler supports only one terminal with one slot per
instance, it can choose to ignore the Lun.
The Logical Unit Number, Lun is encoded as 0xXXXXYYYY, where
YYYY represents the lower 16 bits that correspond to the slot num‐
ber for terminals with multiple slots. Most of the readers
have only one slot, in which case YYYY is 0.
XXXX represents the next 16 bits that correspond to the card termi‐
nal and can range between 0 and a number returned by
TAG_IFD_SUMULTANEOUS_ACCESS.
RETURN VALUES
The following values are returned:
IFD_SUCCESS Successful completion.
IFD_COMMUNICATION_ERROR An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Evolving │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOattributes(5)NOTES
This manual page is derived from the MUSCLE PC/SC IFD Driver Developer
Kit documentation. License terms and attribution and copyright informa‐
tion for this interface are available at the default location
/var/sadm/pkg/SUNWocfh/install/copyright. If the Solaris Operating
Environment has been installed anywhere other than the default loca‐
tion, modify the path to access the file at the installed location.
SunOS 5.10 4 Dec 200IFDHCreateChannelByName(3SMARTCARD)