Ips_Loadmasterenckey() - VeriFone MX800 series Programmer's Manual

iPS_LoadMasterEncKey()

This function loads the security script's master keys without deleting the keys
already loaded. The new values must be presented encrypted under the current
value of VSS_KLK.
This function can be used to load the keys defined by the Security Scripts if the
option has not been disabled in the script.
An error code will be returned if the VSS_KLK is not present.
Prototype
int iPS_LoadMasterEncKey(unsigned char ucKeySetID, unsigned char
ucKeyID, unsigned char * pucINKeyValue)
Parameters
The key set identifier.
ucKeyID
00
01
...
07
The key identifier.
ucKeyID
pointer to the 8-byte buffer containing the cleartext value Master
pucINKeyValue
Key.
Return Values
0
E_KM_NO_KEY_LOADED
E_KM_KEY_INTEGRITY_ERROR
E_KM_OUT_OF_RANGE
E_KM_FEATURE_DISABLED
E_KM_SYSTEM_ERROR
Key set defined in VeriShield Security Script #0
Key set defined in VeriShield Security Script #1
Key set defined in VeriShield Security Script #7
Master key number / Key index in the selected set
Successful execution
VSS_KLK is absent. No encrypted loading
possible
VSS_KLK is corrupted
ucKeySetID or ucKeyID is out of range or
script is not loaded.
Master/Session support disabled by a script
D
iPS_LoadMasterEncKey()
X
M 800 S P
ERIES ROGRAMMERS
D
EVICE RIVERS
63
G
UIDE