VeriFone MX800 Series - Ips_Checkmasterkey()

DEVICE DRIVERS
iPS_CheckMasterKey()
64 M
X
800 SERIES PROGRAMMERS GUIDE
iPS_CheckMasterKey()
This function indicates whether a key is present in the specified location.
The Key Verification Code (KVC) argument is irrelevant in M
x
800 series of
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
Return Values
ucKeyID The key set identifier.
ucKeyID The key identifier.
pucINKVC not used
0 Successful execution
E_KM_NO_KEY_LOADED The key is not loaded
E_KM_KEY_INTEGRITY_ERROR The key is corrupted
E_KM_OUT_OF_RANGE ucKeySetID or ucKeyID is out of range
E_KM_SYSTEM_ERROR
00 Key set defined in VeriShield Security Script #0
01 Key set defined in VeriShield Security Script #1
...
07 Key set defined in VeriShield Security Script #7
08 PIN Master Key (Master/Session)
09 MAC Master Key (Master/Session)
Master key number / Key index in the selected set