Content-type: text/html Man page of IFDHCreateChannelByName

IFDHCreateChannelByName

Section: Smartcard Library Functions (3SMARTCARD)
Updated: 4 Dec 2002
Index Return to Main Contents
 

NAME

IFDHCreateChannelByName - 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 communication 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 number 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 terminal 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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving

 

SEE ALSO

attributes(5)  

NOTES

This manual page is derived from the MUSCLE PC/SC IFD Driver Developer Kit documentation. License terms and attribution and copyright information 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 location, modify the path to access the file at the installed location.


 

Index

NAME
SYNOPSIS
PARAMETERS
Input
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:38:33 GMT, October 02, 2010