Ips_Loadmasterclearkey() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

iPS_LoadMasterClearKey()

iPS_LoadMasterClearKey()
62
M X 800 S P
ERIES ROGRAMMERS
This function loads the master key of the security script. The values are sent in the
clear, but must be all loaded in a same session. Before loading the first key after a
power cycle, all keys previously loaded (including the system keys) are erased.
This means that loading additional keys in a different session must be done in
encrypted form.
This function can be used to load the keys defined by the Security Scripts if the
option has not been disabled in the script.
This function should be exclusively used in a secure environment.
Prototype
int iPS_LoadMasterClearKey(unsigned char ucKeySetID,unsigned char
ucKeyID, unsigned char * pucINKeyValue)
Parameters
ucKeyID The key set identifier.
00
01
...
07
ucKeyID The key identifier.
Master key number / Key index in the selected set
pucINKeyValue pointer to the 8-byte buffer containing the cleartext value Master
Key.
Return Values
0
E_KM_OUT_OF_RANGE
E_KM_FEATURE_DISABLED
E_KM_SYSTEM_ERROR
G
UIDE
Key set defined in VeriShield Security Script #0
Key set defined in VeriShield Security Script #1
Key set defined in VeriShield Security Script #7
Successful execution
ucKeySetID or ucKeyID is out of range or
script is not loaded.
Master/Session support disabled by a script