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.