ifdhcreatechannel(3smartca) [sunos man page]

IFDHCreateChannel(3SMARTCARD)				    Smartcard Library Functions 			     IFDHCreateChannel(3SMARTCARD)

NAME

       IFDHCreateChannel - create a communication channel with an IFD

SYNOPSIS

       #include <smartcard/ifdhandler.h>

       RESPONSECODE IFDHCreateChannel(DWORD Lun, DWORD Channel);

PARAMETERS

       The IFDHCreateChannel() function takes the following parameters:

   Input
       Lun	       Logical Unit Number

       Channel	       Channel ID

DESCRIPTION

       The  IFDHCreateChannel()  function is similar to IFDHCreateChannelByName(3SMARTCARD). It takes Channel (a number) as an argument instead of
       the device name string. The Channel argument is typically passed from configuration information by the smart card  framework  server/daemon
       (the caller) to the IFD handler. The IFD handler can use this Channel appropriately to create a communication channel to the card terminal.

RETURN VALUES

       The following values are returned:

       IFD_SUCCESS		       Successful completion.

       IFD_COMMUNICATION_ERROR	       An error has occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       IFDHCreateChannelByName(3SMARTCARD), 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.

SunOS 5.10							    4 Dec 2002					     IFDHCreateChannel(3SMARTCARD)

IFDHGetCapabilities(3SMARTCARD) 			    Smartcard Library Functions 			   IFDHGetCapabilities(3SMARTCARD)

NAME

       IFDHGetCapabilities - get IFD capabilities

SYNOPSIS

       #include <smartcard/ifdhandler.h>

       RESPONSECODE IFDHGetCapabilities(DWORD Lun, DWORD Tag, PDWORD Length, PUCHAR Value);

PARAMETERS

       The IFDHGetCapabilities() function takes the following parameters:

   Input
       Lun	       Logical Unit Number

       Tag	       Tag of the desired data value

       Length	       Maximum length of the desired data value

   Output
       Length	       Length of the data returned

       Value	       Value of the desired data

DESCRIPTION

       The IFDHGetCapabilities() function retrieves the terminal or card capabilities for the terminal or card specified by Lun.

       The Tag parameter can have one of the following values:

       TAG_IFD_ATR		       Return the ATR (Answer To Reset). This is the default value.

       TAG_IFD_SIMULTANEOUS_ACCESS     Return  the number of sessions the driver can handle. This value is used for multiple terminals sharing the
				       same IFD handler.

       TAG_IFD_SLOTS_NUMBER	       Return the number of slots in this terminal.

       If the TAG_IFD_SIMULTANEOUS_ACCESS and TAG_IFD_SLOTS_NUMBER tags are not supported, the error value IFD_ERROR_TAG must be returned.

RETURN VALUES

       The following values are returned:

       IFD_SUCCESS		       Successful completion.

       IFD_ERROR_TAG		       An error occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       IFDHCreateChannelByName(3SMARTCARD), 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.

SunOS 5.10							    4 Dec 2002					   IFDHGetCapabilities(3SMARTCARD)