IFDHSetProtocolParameters(3SMARTCARD)			    Smartcard Library Functions 		     IFDHSetProtocolParameters(3SMARTCARD)

NAME

       IFDHSetProtocolParameters - set protocol parameters

SYNOPSIS

       #include <smartcard/ifdhandler.h>

       RESPONSECODE IFDHSetProtocolParameters(DWORD Lun, DWORD Protocol, UCHAR Flags, UCHAR PTS1, UCHAR PTS2, UCHAR PTS3);

PARAMETERS

       The IFDHSetProtocolParameters() function takes the following parameters:

   Input
       Lun	       Logical Unit Number

       Protocol        Desired protocol

       Flags	       The bitwise-inclusive OR of the flags

       PTS1	       1st PTS Value

       PTS2	       2nd PTS Value

       PTS3	       3rd PTS Value

DESCRIPTION

       The  IFDHSetProtocolParameters()  function sets the Protocol Type Selection (PTS) of the slot or card using the three PTS values as defined
       in ISO 7816.

       The Protocol parameter can take an integer value between 0 and 14, inclusive, corresponding to the protocol T=0, T=1, ..., T=14.

       The Flags parameter can have the value of one of the following or the bitwise-inclusive OR of two or more of the following:

       IFD_NEGOTIATE_PTS1      Use the PTS1 value.

       IFD_NEGOTIATE_PTS2      Use the PTS2 value.

       IFD_NEGOTIATE_PTS3      Use the PTS3 value.

RETURN VALUES

       The following values are returned:

       IFD_SUCCESS		       Successful completion.

       IFD_COMMUNICATION_ERROR	       An error occurred.

       IFD_ERROR_PTS_FAILURE	       The PTS value could not be set.

       IFD_PROTOCOL_NOT_SUPPORTED      The protocol is not supported.

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 is 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				     IFDHSetProtocolParameters(3SMARTCARD)