Ips_Requestpinentry() - VeriFone MX800 series Programmer's Manual

iPS_RequestPINEntry()

This function initiates the PIN collection. Once the PIN entry is completed, the PIN
is formatted and encrypted according to the algorithm specified by the previous
function iPS_SelectPINAlgo. The encrypted PIN block is then placed in a
buffer and made available for the iPS_GetPINResponse function. This function
is not "blocking", this allows the unit to perform other tasks while the customer is
entering his PIN.
Prototype
int iPS_RequestPINEntry( unsigned char cPANDataSize, unsigned char *
pucINPANData)
Parameters
ucPANDataSize
pucINPANData
Return Values
0
E_KM_ACCESS_DENIED
E_KM_BAD_SEQUENCE
E_KM_SYSTEM_ERROR
RFU – this parameter is ignored in M
terminals.
RFU – this parameter is ignored in M
terminals.
Successful execution
You requested too many PIN sessions in a short
period of time. Try again in few seconds. See
Note on the PIN session
A PIN session is already started
D
iPS_RequestPINEntry()
x
800 series of
x
800 series of
timeout.
X
M 800 S P
ERIES ROGRAMMERS
D
EVICE RIVERS
69
G
UIDE