Ips_Getpinresponse() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

iPS_GetPINResponse()

iPS_GetPINResponse()
70
M X 800 S P
ERIES ROGRAMMERS
This function checks the status of the PIN session. It will typically be used by the
application in a loop to poll the system until the PIN session ends. The information
returned by this function during the PIN session can be used in conjunction with a
timer to implement an inter-character timeout as required in certain countries The
functions returns the number of PIN digits entered and the last non-numeric
pressed.
Prototype
int ippGetPINResponse (int * piStatus, PINRESULT * pOUTData)
Parameters
piStatus
OK
(0x00)
0x01
0x02
0x05
0x06
0x0A
0x0C
G
UIDE
Done. Data contains the result of the comparison/
encryption.
Unit is idle
Collecting PIN
Aborted by user: The <CANCEL> key has been pressed.
NO PIN entered (Only if this option is turned on)
Aborted by user: The <CLEAR> key has been pressed
with no PIN digit in the buffer (The user had not entered
any PIN digit, or had already cleared out all the PIN
digits). This value can be obtained only if ucOption.bit4
has been set using function ippSetPINParameters().
The PIN session timed out. See
timeout.
Note on the PIN session