DEVICE DRIVERS
iPS_LoadSysClearKey()
60 M
X
800 SERIES PROGRAMMERS GUIDE
iPS_LoadSysClearKey()
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
Return Values
ucKeyID The key identifier.
pucINKeyValue 16-byte buffer containing the clear-text key
0 Successful execution
E_KM_NO_KEY_LOADED VSS_KLK is absent. No encrypted loading
possible
E_KM_KEY_INTEGRITY_ERROR VSS_KLK is corrupted
E_KM_SYSTEM_ERROR
0x00 VSS_KLK (16 bytes)