Description The PIN, which was entered with the WFS_PIN_GET_PIN command, is combined with the requisite data specified by the VISA validation algorithm and locally verified for correctness. The result of the verification is returned to the application. This command will clear the PIN.
Input Param LPWFSPINLOCALVISA lpLocalVISA;
typedef struct _wfs_pin_local_visa
{
LPSTR lpsPAN;
LPSTR lpsPVV;
WORD wPVVDigits;
LPSTR lpsKey;
LPWFSXDATA lpxKeyEncKey;
} WFSPINLOCALVISA, * LPWFSPINLOCALVISA;
lpsPAN
Primary Account Number from track data.
lpsPVV
PIN Validation Value from track data.
wPVVDigits
Number of digits of PVV.
lpsKey
Name of the validation key.
lpxKeyEncKey
If NULL, lpsKey is used directly for PIN validation. Otherwise, lpsKey is used to decrypt the encrypted key passed in lpxKeyEncKey and the result is used for PIN validation.
Output Param LPBOOL lpbResult;
lpbResult
Pointer to a boolean value which specifies whether the PIN is correct or not.
Error Codes The following additional error codes can be generated by this command:
Value Meaning
WFS_ERR_PIN_KEYNOTFOUND The specified key was not found.
WFS_ERR_PIN_KEYNOVALUE The specified key is not loaded.
WFS_ERR_PIN_USEVIOLATION The specified use is not supported by this key.
WFS_ERR_PIN_ACCESSDENIED The encryption module is either not initialized or not ready for any vendor specific reason.
WFS_ERR_PIN_NOPIN PIN has not been entered or has been cleared.
Events The following additional events can be generated by this command:
Value Meaning
WFS_SRVE_PIN_ILLEGAL_KEY_ACCESS An error occured accessing an encryption key.
Comments None.