TlpIccIncomingCommand

PURPOSE

Send an APDU with incomming data.

PROTOTYPE

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

PARAMETERS

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

DESCRIPTION

Send a case-3 APDU to the ICC, i.e., an APDU with command data (a.k.a. incoming data) but no response data.

commandData is a raw APDU (CLA, INS, P1, P2, Length [,data...]). whose length is detemined by looking at the fifth byte.

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 2 bytes wide since it only contains SW1 and SW2.

response can be NULL to discard the ICC response.

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

TlpIccOutgoingCommand,
TlpIccIncomingOutgoingCommand.