Ips_Loadsysclearkey() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

iPS_LoadSysClearKey()

iPS_LoadSysClearKey()
60
M X 800 S P
ERIES ROGRAMMERS
This function loads the VSS_KLK (i.e. system keys). The values are presented in
the clear. Before writing the new value of the key, all other keys in the terminal are
erased.
This function should be exclusively used in a secure environment.
Prototype
int iPS_LoadSysClearKey(unsigned char ucKeyID, unsigned char *
pucINKeyValue)
Parameters
The key identifier.
ucKeyID
0x00
16-byte buffer containing the clear-text key
pucINKeyValue
Return Values
0
E_KM_NO_KEY_LOADED
E_KM_KEY_INTEGRITY_ERROR
E_KM_SYSTEM_ERROR
G
UIDE
VSS_KLK (16 bytes)
Successful execution
VSS_KLK is absent. No encrypted loading
possible
VSS_KLK is corrupted