SDK API > BS2_SetDataEncryptKey

[+ 2.7.1] Changes the user defined PIN encryption key.
If the PIN encryption key on the device is the same as you are trying to change, this configuration will be ignored.
If the PIN encryption key on the device is different from what you are trying to change, the PIN will be configured and it deletes all user information on the device.

CAUTION
If you change PIN encryption key, then it deletes all user information on the device so that it sets the changed user-defined encryption key.
You must transfer all user information using API such as BS2_EnrolUser.
The API BS2_MakePinCode encrypts user PIN with a default key.
If you've ever changed to user-defined PIN encryption key, then PIN needs to be assigned to users again using BS2_MakePinCodeWithKey

Declaration

#include "BS_API.h"
 
int BS2_SetDataEncryptKey(void* context, uint32_t deviceId, const BS2EncryptKey* keyInfo);

Parameter

  • [In] context : Context
  • [In] deviceId : Device ID
  • [In] keyInfo : The address of the key information structure to set.

Return Value

If successfully done, BS_SDK_SUCCESS will be returned.
If there is an error, the corresponding error code will be returned.

See Also