TlpIccIncomingOutgoingCommand

PURPOSE

Send an APDU with incomming data.

PROTOTYPE

Trap: TlpErr TlpIccIncomingOutgoingCommand (UInt16 refNum, const UInt8 *commandData, UInt16 commandLength, UInt8 *response, UInt16 *responseLength)

PARAMETERS

commandData	IN		the APDU to send
commandLength	IN		the length of commandData
response		OUT	the command result
responseLength	IN	OUT	the size of response

DESCRIPTION

Send a case-4 APDU to the ICC, i.e., an APDU with command data (a.k.a. ingoing data) expecting response data (a.k.a. outgoing data). This is the general APDU case.

commandData is a raw APDU (CLA, INS, P1, P2 [, Length [, data... [, ExpectedLength]]]) of length commandLength.

response is filled with the card response up to responseLength bytes, and responseLength is adjusted to the number of bytes written. This response is expected to be ExpectedLength+2 bytes wide because SW1 and SW2 are also copied.

RETURN CODES

tlpSuccess

Successfull operation.

tlpErrUnknownReaderCommand

Unknow reader command (not a valid command code).

tlpErrIccUnsupportedProtocol

ICC protocol not supported (ICC command rejected).

tlpErrResetUnsupportedProtocol

ICC interface or protocol not supported (warning on ATR).

tlpErrIccParityError

ICC command with parity error (maybe ICC is off).

tlpErrIccRemoved

ICC removed (the card was withdrawn while carrying out the command).

tlpErrIccAbsent

ICC not present in the terminal.

tlpErrIccNok

Warning on an ICC command (SW is not 0x9000).

tlpErrPalmOS

Error from the Palm host (such as a serial or memory error). Call TlpGetLastErr to get the last Palm error code.

tlpErrConversation

Conversation error between the host and the terminal.

SEE ALSO

TlpIccIncomingCommand,
TlpIccOutgoingCommand.