ResetPIN
ResetPIN(oldPIN, newPIN, cardString) resets the PIN by de-camouflaging the credential provided by application using old user PIN and re-camouflage it using new PIN value. It accepts old user pin and new user pin as an input and returns the new PIN camouflaged card string, which the application stores back in a persistent storage.
aa821test
Description
ResetPIN(oldPIN, newPIN, cardString) resets the PIN by de-camouflaging the credential provided by application using old user PIN and re-camouflage it using new PIN value. It accepts old user pin and new user pin as an input and returns the new PIN camouflaged card string, which the application stores back in a persistent storage.
API Signature
CAMOBILEOTPCRYPTOSDK_API SDK_STATUS ResetPIN(const std::string& oldPIN,const std::string& newPIN,std::string& cardString)throw()
Parameters
oldPIN [in]
Old user PIN provided by application. Crypto SDK does not perform any validation for pin value.
newPIN [in]
New user PIN provided by application. Crypto SDK does not perform any validation for pin value. Application developer validates pin value against the MPL_ or PTYP card attributes. Application can fetch value of the card attribute using GetCardAttributeValue().
cardString [in/out]
Card string retrieved from the persistent storage. Application needs to store back updated card string.
Return Values
Return Value | Inference |
SDKSTATUS_OK | Successful |
SDKSTATUS_BADPARAM | CardString is empty |
SDKSTATUS_ERROR_INVALID_CARDSTRING | CardString is corrupt or invalid |
SDKSTATUS_INTERNAL_ERROR | Unable to reset PIN |
Remarks
Any special case for APIs input parameter or return values or special.