This section describes only module-specific error codes. For details about universal error codes, please refer to Universal Error Codes.
Message
permission denied.
Symptom
Permission verification failed.
Possible causes
The HAP has not obtained the digital shield permission in AppGallery Connect.
Solution
Only apps that meet the application scenario requirements can apply for this permission. Enable the digital shield service. For details, please refer to Enabling Device Security Kit.
Message
argument is invalid.
Symptom
Parameter check failed.
Possible causes
A mandatory parameter is missing, or the parameter type or specifications are invalid.
Solution
Make sure all the mandatory parameters are passed and the parameter types and specifications are valid.
Message
The number of consecutive authentication failures exceeds the maximum.
Symptom
The number of consecutive password authentication failures reaches the upper limit allowed by the digital shield service.
Possible causes
The user forgets the password, or an attacker attempts to crack the password by brute force.
Solution
The digital shield is locked. You can provide a reactivation process for the user based on the service scenario.
Message
delete trusted authentication password failed.
Symptom
Internal error.
Possible causes
An exception occurred when other system APIs are called in the password deletion process.
Solution
Try again later. If the error persists, submit a ticket online.
Message
trusted authentication verify failed.
Symptom
Internal error.
Possible causes
An exception occurred when other system APIs are called in the password authentication process.
Solution
Try again later. If the error persists, submit a ticket online.
Message
Check input confirm text failed.
Symptom
Internal error.
Possible causes
The device does not support TUI or the TUI service is faulty.
Solution
Check whether the device supports the digital shield capability. If so, try again. If the retry fails, submit a ticket online for assistance.
Message
Unsupported custom image.
Symptom
The input image format is not supported.
Possible causes
The input image format does not meet the requirements. The digital shield service APIs require that the image format be RGBA PNG and the image width and height be within 216.
Solution
Ensure that the input image meets the format requirements of the digital shield service.
Message
The user canceled the operation.
Symptom
The service operation is canceled by the user.
Possible causes
The user cancels the operation on the TUI or the TUI automatically exits after 2 minutes of user inactivity.
Solution
This is not an error, as the user proactively ends the process.
Message
Failed to export data.
Symptom
Failed to export the backup data.
Possible causes
The corresponding backup data is not imported, or the password authentication fails during backup data export.
Solution
Ensure that the data has been correctly imported and the user password authentication is successful during data export.
Message
Failed to import data.
Symptom
Failed to import the backup data.
Possible causes
The backup data can be imported only once. If the backup data is imported repeatedly, an error is reported.
Solution
Ensure that the data is correctly imported for the first time. When the digital shield service is disabled, the lifecycle of the imported data ends.
Message
The text content cannot be displayed.
Symptom
Invalid TUI authentication information.
Possible causes
The entered authentication information is in an invalid format or exceeds the allowed length.
Solution
Ensure that the entered TUI authentication information meets the requirements.
Message
Invalid authentication ID.
Symptom
Invalid authID.
Possible causes
The password authID passed during the operation is different from that obtained when the password is created.
Solution
Ensure that the passed authID is the one obtained when the password is created.
Message
Set trusted authentication password failed.
Symptom
Internal error.
Possible causes
An exception occurred when other system APIs are called in the password creation process.
Solution
Try again later. If the error persists, submit a ticket online.
Message
Modify trusted authentication password failed.
Symptom
Internal error.
Possible causes
An exception occurred when other system APIs are called in the password change process.
Solution
Try again later. If the error persists, submit a ticket online.
Message
Get biometric authToken failed.
Symptom
Internal error.
Possible causes
The input tuiAuthToken and bioAuthToken are from different sessions, or the ATL level of bioAuthToken is not ATL4.
Solution
Troubleshoot the possible causes first. If none of the possible causes is involved, submit a ticket online.
Message
The trusted authentication feature is not enabled.
Symptom
The digital shield service is not enabled.
Possible causes
The device does not support the digital shield service, or the digital shield service fails to be enabled on the device.
Solution
Ensure that the device supports the digital shield service.
Message
Failed to get the remaining number of authentication attempts.
Symptom
Failed to obtain the number of remaining authentication times of the digital shield.
Possible causes
An exception occurred when other system APIs are called in the process of obtaining the number of remaining authentication times of the digital shield.
Solution
Try again later. If the error persists, submit a ticket online.
Message
Failed to unbind the corresponding biometric data.
Symptom
Failed to disable the authentication capability of a specified biometric feature.
Possible causes
An exception occurred when other system APIs are called in the process of disabling the authentication capability of a specified biometric feature.
Solution
Try again later. If the error persists, submit a ticket online.
Message
The biometric data for authentication does not match the bound biometric feature.
Symptom
The authenticated biometric feature does not match the bound biometric feature.
Possible causes
The authenticated biometric feature, for example, fingerprint, does not match the bound biometric feature.
Solution
Instruct the user to use the bound biometric feature for authentication.
Message
The biometric data has already been bound.
Symptom
The biometric feature is bound repeatedly.
Possible causes
The biometric feature is bound repeatedly.
Solution
Notify the user that the biometric feature has been bound.
Message
The corresponding biometric data has not been bound.
Symptom
The biometric feature is not bound.
Possible causes
During biometric authentication or biometric feature unbinding, it is found that the corresponding biometric feature is not bound.
Solution
Ensure that the biometric feature has been bound.
Message
Secure element fault.
Symptom
The security element is faulty.
Possible causes
The security element is faulty.
Solution
Enable the TEE-level digital shield.
Message
The bound biometric ID is invalid.
Symptom
The bound biometric ID is invalid.
Possible causes
The bound biometric feature has been deleted from the system.
Solution
Unbind the specified biometric feature from the digital shield service and bind a valid biometric ID.
Message
The TUI is occupied by another app.
Symptom
The TUI is occupied by another app.
Possible causes
The TUI does not support concurrent operations. If another app is currently occupying the TUI, subsequent requests to launch the TUI will fail.
Solution
Exit the occupied TUI or wait for the app using the TUI to finish its operation before initiating the request again.