Star767
4993
代码
代码
Issues1667
Pull Requests1778
流水线
讨论
Wiki
分析
Star767
4993
luoyilingluoyilingupdate docs
40576da1创建于 2025年12月23日历史提交

HUKS Error Codes

NOTE

This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.

12000001 Feature Not Supported

Error Message

The ${messageInfo} is not supported.

Description

The features specified in ${messageInfo} are not supported.

Possible Causes

The API is supported, but certain features in the API, such as the algorithm, are not supported.

Solution

Adjust the API parameters and use the supported alternative parameters.

12000002 Missing Key Algorithm Parameter

Error Message

Failed to obtain the ${messageInfo}. It is not set in ParamSet.

Description

The parameters in ${messageInfo} cannot be obtained because related parameters are not set.

Possible Causes

The key parameter is not set.

Solution

  1. Determine the missing parameter from the error message.
  2. Set the parameter.

12000003 Invalid Key Algorithm Parameter

Error Message

Invalid ${messageInfo}.

Description

An invalid parameter is used. For details, see ${messageInfo}.

Possible Causes

The related parameters are invalid when the key is used.

Solution

  1. Determine the invalid parameter from the error message.
  2. Correct the invalid parameter.

12000004 File Error

Error Message

A file error can be any of the following:

  • Insufficient storage space.
  • Invalid file size.
  • Failed to ${messageInfo}.

Description

A file error can be any of the following:

  • Disk is full.
  • Invalid file size.
  • The file cannot be accessed. For details, see ${messageInfo} in the log.

Possible Causes

The file operation failed.

Solution

  1. Check whether the sufficient disk space is available and whether the file system is normal.
  2. Clear the disk space.

12000005 IPC Error

Error Message

A file error can be any of the following:

  • Failed to get messages from IPC.
  • IPC ${messageInfo}.

Description

A file error can be any of the following:

  • Failed to obtain messages from the IPC.
  • An IPC error occurs. For details about the cause, see ${messageInfo} in the log.

Possible Causes

The Inter-Process Communication (IPC) failed.

Solution

Locate and rectify the IPC failure.

12000006 Algorithm Library Operation Failed

Error Message

Crypto engine error or Ukey driver error.

Description

The algorithm library operation or UKey driver operation fails.

Possible Causes

The possible causes are as follows:

  1. The encryption and decryption on the algorithm library failed due to incorrect ciphertext data.
  2. Incorrect key parameters exist.

Solution

  1. Check and correct the ciphertext data.
  2. Check and correct the key parameters.

12000007 Failed to Access the Key Due to Invalidated Credential

Error Message

This credential is invalidated permanently.

Description

The current credential has expired permanently.

Possible Causes

The possible causes include the following:

  1. The key is configured with the user access control attribute and becomes invalid after the password is cleared.
  2. The key is configured with the user access control attribute and becomes invalid after a new biometric feature is enrolled.

Solution

  1. Locate the cause of the authentication failure based on the log.
  2. If the authentication fails due to the configuration of the access control attribute, the key cannot be used any longer.

12000008 Failed to Access the Key Due to a Failure in Authentication Token Verification

Error Message

The authentication token verification failed.

Description

The user token cannot pass the authentication.

Possible Causes

The challenge value is incorrect.

Solution

  1. Check whether the challenge for user IAM authentication is correctly assembled.
  2. If the challenge value is incorrect, modify the assembly mode, use the bytes generated by HUKS to assembly the challenge value, and pass it to user IAM for authentication.

12000009 Key Access Timed Out

Error Message

This authentication token timed out.

Description

The token of the current user has timed out.

Possible Causes

The authentication failed because the authentication token timed out.

Solution

Initialize the key and perform the authentication again. Ensure that the difference between the current time and the authentication token generation time is less than the timeout interval.

12000010 Key Operation Sessions Reaches the Limit

Error Message

The number of key operation sessions has reached the limit.

Description

The number of key operation sessions has reached the limit.

Possible Causes

The number of concurrent key operation sessions has reached the maximum (15).

Solution

  1. Check whether there are multiple key session operations (init operations) for the same application. If yes, modify the code to avoid concurrent invoking.
  2. If the key operation sessions are set up for different applications, wait until the sessions are released.

12000011 The Entity Does Not Exist

Error Message

Queried entity does not exist.

Description

The target object does not exist.

Possible Causes

The key corresponding to the key alias does not exist.

Solution

  1. Check whether the key alias is correctly spelled.
  2. Check whether the key corresponding to the key alias is successfully generated.

12000012 External Error

Error Message

Device environment or input parameter abnormal.

Description

The device environment or input parameters are abnormal.

Possible Causes

An external error, such as a hardware fault or file error, occurs.

Solution

Provide the error code and log information to the related party.

12000013 The Credential Does Not Exist

Error Message

The credential does not exist.

Description

The current credential does not exist.

Possible Causes

The credential, such as the PIN, fingerprint, or face image, is not enrolled.

Solution

Enroll the credential or change the authentication type bound to the key.

12000014 Insufficient Memory

Error Message

A file error can be any of the following:

  • Insufficient memory.
  • Malloc failed.

Description

A file error can be any of the following:

  • The memory is insufficient.
  • Failed to allocate memory.

Possible Causes

The system memory is insufficient, or the buffer allocated for the output parameter is too small.

Solution

  1. Release memory or restart the device.
  2. Check whether the buffer allocated for the output parameter is too small.

12000015 Failed to Invoke Other System Services

Error Message

Failed to obtain the ${messageInfo} information via UserIAM.

Description

Failed to obtain the ${messageInfo} information through UserIAM.

Possible Causes

The called system service has not started.

Solution

Wait for the system service to start and call the API again.

12000017 Duplicate Key Alias

Error Message

The key with same alias is already exist.

Description

A key with the same name already exists.

Possible Causes

The same key alias already exists and cannot be overwritten.

Solution

Check whether the same key alias needs to be overwritten as needed.

12000018 Invalid Input Parameter

Error Message

The input parameter is invalid.

Description

The entered parameter is invalid.

Possible Causes

  1. A mandatory parameter is not passed.

  2. A parameter type is incorrect (Type Error).

  3. A null parameter is incorrect (Null Argument Error).

  4. A value range is incorrect (Value Range Error).

Solution

Make sure all the mandatory parameters are passed in and the types of the passed-in parameter are valid. If parameter verification fails, read the parameter specifications and locate the fault based on the possible causes.

12000019 Provider Name Already Registered

Error Message

The provider is already registered.

Description

The provider to be registered already exists.

Possible Causes

The provider to be registered already exists.

Solution

Check whether the provider to be registered is correct. If the provider is correct, deregister the provider and register it again.

12000020 Dependent Module Error

Error Message

The provider operation failed.

Description

The downstream dependent module reports an error.

Possible Causes

The downstream dependent module reports an error.

Solution

Check the cause of the error reported by the downstream module based on the error code or error message returned.

12000021 UKey PIN Locked

Error Message

The Ukey PIN is locked.

Description

The UKey PIN is locked.

Possible Causes

The PIN is locked due to too many incorrect PIN attempts.

Solution

Contact the bank to unlock the UKey.

12000022 Incorrect UKey PIN

Error Message

The Ukey PIN is incorrect.

Description

The UKey PIN is incorrect.

Possible Causes

The PIN is incorrect.

Solution

Enter the correct PIN.

12000023 Unauthenticated UKey PIN

Error Message

The Ukey PIN is not authenticated.

Description

The UKey PIN is not authenticated.

Possible Causes

PIN authentication is required for the operation, but the PIN has not been authenticated.

Solution

PIN authentication is required for the operation, but the PIN has not been authenticated.

12000024 Device or Resource Busy

Error Message

The provider or Ukey is busy.

Description

The device or resource is busy.

Possible Causes

The device or resource is busy.

Solution

Try again, or remove and insert the UKey and try again.

12000025 Resource Limit Exceeded

Error Message

The resource exceeds the limit.

Description

The resource limit is exceeded.

Possible Causes

The resource limit is exceeded.

Solution

Check whether there are unreleased resources. If yes, release the resources and try again.