VeriFone MX800 Series - Ips_Setpinparameter()

DEVICE DRIVERS
iPS_SetPINParameter()
66 M
X
800 SERIES PROGRAMMERS GUIDE
iPS_SetPINParameter()
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 Minimum number of PIN digits. It must be in the range [4..12].
ucMax Maximum number of PIN digits. It must be at least equal to
Min but not greater than 12.
ucEchoChar
Not used on M
x
800 series. The characters echoing PIN digits
are displayed by the
SetSecurePINDisplayParameters()’s callback
function.
ucDefChar
Not used on M
x
800 series of terminals. The default field fill
characters are displayed using the
SetSecurePINDisplayParameters() callback function.
ucOption.bit0 =1 turns Auto Enter feature O
ucOption.bit1 =1 accepts NO PIN entry (pressing ENTER before any digit).
ucOption.bit2 RFU - Must be 0
ucOption.bit3 =1 makes the <CLEAR> key behave like a backspace key.
Only one digit is deleted instead of all the digits entered so
far.
ucOption.bit4 =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.
ucOption.bit5..7 RFU - Must be 0