ifdhsetprotocolparameters(3smartca) [sunos man page]
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)
Check Out this Related Man Page
SCF_Terminal_getCard(3SMARTCARD) Smartcard Library Functions SCF_Terminal_getCard(3SMARTCARD) NAME
SCF_Terminal_getCard - establish a context with a smartcard SYNOPSIS
cc [ flag... ] file... -lsmartcard [ library...] #include <smartcard/scf.h> SCF_Status_t SCF_Terminal_getCard(SCF_Terminal_t terminal, SCF_Card_t *card); PARAMETERS
card A pointer to a SCF_Card_t. If the smartcard is successfully opened, a handle for the card will be returned through this parameter. terminal The terminal (from SCF_Session_getTerminal(3SMARTCARD)) containing a smartcard to open. DESCRIPTION
The SCF_Terminal_getCard() function establishes a context with a specific smartcard in a terminal. Card objects can be used to send APDUs (Application Protocol Data Units) to the card with SCF_Card_exchangeAPDU(3SMARTCARD). When the card is no longer needed, SCF_Card_close(3SMARTCARD) should be called to release allocated resources. If SCF_Terminal_getCard() is called multiple times in the same session to access the same physical card (while the card remains inserted), the same SCF_Card_t will be returned in each call. The library cannot identifty specific cards, so when a card is reinserted it will be represented by a new SCF_Card_t. Multithreaded applications must take care to avoid having one thread close a card that is still needed by another thread. This can be accomplished by coordination within the application, or by having each thread open a separate session to avoid interference. RETURN VALUES
If a working card is present in the reader, SCF_STATUS_SUCCESS is returned and card is a valid reference to the card. Otherwise, an error value is returned and card remains unaltered. ERRORS
The SCF_Terminal_getCard() function will fail if: SCF_STATUS_BADARGS The card argument is a null pointer. SCF_STATUS_BADHANDLE The specified terminal has been closed or is invalid. SCF_STATUS_FAILED An internal error occured. SCF_STATUS_NOCARD No card is present in the terminal. EXAMPLES
Example 1: Access a smartcard. SCF_Status_t status; SCF_Terminal_t myTerminal; SCF_Card_t myCard; /* (...call SCF_Session_getTerminal to open myTerminal...) */ status = SCF_Terminal_getCard(myTerminal, &myCard); if (status == SCF_STATUS_NOCARD) { printf("Please insert your smartcard and try again. "); exit(0); } else if (status != SCF_STATUS_SUCCESS) exit(1); /* (...go on to use the card with SCF_Card_exchangeAPDU()...) */ ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
libsmartcard(3LIB), SCF_Card_close(3SMARTCARD), SCF_Card_exchangeAPDU(3SMARTCARD), SCF_Card_getInfo(3SMARTCARD), SCF_Card_lock(3SMARTCARD), SCF_Session_getTerminal(3SMARTCARD), attributes(5) SunOS 5.10 28 Feb 2001 SCF_Terminal_getCard(3SMARTCARD)