Ips_Checkmasterkey() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

iPS_CheckMasterKey()

iPS_CheckMasterKey()
64
M X 800 S P
ERIES ROGRAMMERS
This function indicates whether a key is present in the specified location.
The Key Verification Code (KVC) argument is irrelevant in M
terminals because this function is used only for security script keys. The key may
be part of a double or triple length DES key, so for security reasons we cannot
return the KVC of a portion of the key.
Prototype
int iPS_CheckMasterKey(unsigned char ucKeySetID, unsigned char ucKeyID,
unsigned char * pucINKVC)
Parameters
The key set identifier.
ucKeyID
00
01
...
07
08
09
The key identifier.
ucKeyID
Master key number / Key index in the selected set
not used
pucINKVC
Return Values
0
E_KM_NO_KEY_LOADED
E_KM_KEY_INTEGRITY_ERROR
E_KM_OUT_OF_RANGE
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
PIN Master Key (Master/Session)
MAC Master Key (Master/Session)
Successful execution
The key is not loaded
The key is corrupted
ucKeySetID or ucKeyID is out of range
x
800 series of