Ips_Setpinparameter() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

iPS_SetPINParameter()

iPS_SetPINParameter()
66
M X 800 S P
ERIES ROGRAMMERS
This function configures several parameters for the upcoming VSS PIN session.
This function has not effect on IPP PIN sessions.
Prototype
int iPS_SetPINParameter( PINPARAMETER * psKeypadSetup)
Parameters
psKeypadSetup
typedef struct {
unsigned char ucMin,
unsigned char ucMax,
unsigned char ucEchoChar,
unsigned char ucDefChar,
unsigned char ucOption,
} PINPARAMETER;
where:
ucMin
ucMax
ucEchoChar
ucDefChar
ucOption.bit0
ucOption.bit1
ucOption.bit2
ucOption.bit3
ucOption.bit4
ucOption.bit5..7
G
UIDE
Minimum number of PIN digits. It must be in the range [4..12].
Maximum number of PIN digits. It must be at least equal to
Min but not greater than 12.
x
Not used on M 800 series. The characters echoing PIN digits
are displayed by the
SetSecurePINDisplayParameters()'s callback
function.
x
Not used on M 800 series of terminals. The default field fill
characters are displayed using the
SetSecurePINDisplayParameters() callback function.
=1 turns Auto Enter feature O
=1 accepts NO PIN entry (pressing ENTER before any digit).
RFU - Must be 0
=1 makes the <CLEAR> key behave like a backspace key.
Only one digit is deleted instead of all the digits entered so
far.
=1 cancels the PIN session when the <CLEAR> key is
pressed with no PIN in the buffer (The user has not entered
any PIN digit, or has already cleared out all the PIN digits).
When the PIN session is cancelled this way, the *piStatus
value returned by iPS_GetPINResponse is 0x0A.
RFU - Must be 0