Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Smartcard Library FunctionsIFDHSetProtocolParameters(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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving

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.9Go To TopLast Changed 4 Dec 2002