Sentinel Licensing API Status Codes

Below is a list of possible return codes related to the operation of the Sentinel Licensing API functions.

No. Status Code Description End User Action Developer Action

0

HASP_STATUS_OK

Request completed successfully.

 

  

1

HASP_MEM_RANGE

Request exceeds the Sentinel protection key memory file.

Contact the vendor's technical support.

 Check the offset or length of the Sentinel key's memory.

2

HASP_INV_PROGNUM_OPT

Invalid program number option.

 

  

3

HASP_INSUF_MEM

The system is out of memory.

Check for the system issue or use larger memory hardware.

  

4

HASP_TMOF

The application has too many open login sessions.

    

5

HASP_ACCESS_DENIED

Access to the Feature, Sentinel protection key, or functionality was denied.

 Contact the vendor's technical support. Check with Thales support.

6

HASP_INCOMPAT_FEATURE

The Legacy decryption function is not compatible with this Feature.

    

7

HASP_HASP_NOT_FOUND

The Sentinel protection key was not found.

 Insert or install a key.  

8

HASP_TOO_SHORT

The encrypted or decrypted data length is too short to execute the function call.

 Contact the vendor's technical support. Increase the data length.

9

HASP_INV_HND

Invalid login handle passed to a function.

 Contact the vendor's technical support. Use the valid handle to log in.

10

HASP_INV_FILEID

The specified file ID is not recognized by the API.

 Contact the vendor's technical support. Validate the file identifier in the application to prevent operations on a non-existing memory file. Ensure that the correct memory field is passed.

11

HASP_OLD_DRIVER

The installed driver or daemon is too old. Install a more recent version of the Run-time Environment.

 Upgrade to the latest driver (RTE) or version.  

12

HASP_NO_TIME

The Real-time clock and V-Clock are not available.

 Contact the vendor's technical support. Check for the real-time clock as it is not available.

13

HASP_SYS_ERROR

Generic error from host system call.

 Contact the vendor's technical support. Generic error.

14

HASP_NO_DRIVER

The hardware key driver was not found.

 Install the driver (RTE).  

15

HASP_INV_FORMAT

An invalid license update or an invalid format string was passed.

 Contact the vendor's technical support. Check the format parameter to create well-formed XML.

16

HASP_REQ_NOT_SUPP

Unable to execute the function in this context; the requested functionality is not supported.

 Check if the requested operation is allowed in this context.  

17

HASP_INV_UPDATE_OBJ

The binary data passed to the function does not contain a valid update.

 Contact the vendor's technical support. The system does not generate a valid V2C file. Generate a new V2C file for the customer.

18

HASP_KEYID_NOT_FOUND

A Sentinel protection key with the requested key ID was not found.

 Contact the vendor's technical support. Ensure that the base license is present on the end user's machine before applying the V2C update.

19

HASP_INV_UPDATE_DATA

Required XML tags were not found.
OR
Contents in binary data are missing or invalid.

 Contact the vendor's technical support. Use the correct file, as the data in the V2C file may be incorrect.

20

HASP_INV_UPDATE_NOTSUPP

The update request is not supported by the Sentinel protection key.

    

21

HASP_INV_UPDATE_CNTR

An update counter mismatch has occurred.

 Contact the vendor's technical support. Check with Thales support.

22

HASP_INV_VCODE   

An invalid vendor code was passed to the function.

 Contact the vendor's technical support. Use the correct vendor code when calling Sentinel LDK Licensing APIs.

23

HASP_ENC_NOT_SUPP

The Sentinel protection key does not support the encryption type currently in use. You may have an obsolete key.

    

24

HASP_INV_TIME

The date or time value passed is outside the supported range.

 Contact the vendor's technical support. Check the time parameter passed in the API. It may be out of range.

25

HASP_NO_BATTERY_POWER

The battery for the HL Time key or HL NetTime key is depleted.

    

26

HASP_NO_ACK_SPACE

Acknowledge the data requested by the update, but the ack_data parameter is NULL.

 Contact the vendor's technical support. Check the ACK data parameter in the hasp_update API. It should not be null.

27

HASP_TS_DETECTED

An application is running on a remote desktop (terminal server).

 Ensure that the licensed application is not accessed using remote desktop.  

28

HASP_FEATURE_TYPE_NOT_IMPL

The requested Feature type is not implemented.

    

29

HASP_UNKNOWN_ALG

An unrecognized algorithm was used in an H2R or V2C file.

 Contact the vendor's technical support. The vendor should use the correct clone protection scheme.

30

HASP_INV_SIG

Signature verification operation failed.

 Contact the vendor's technical support to get a new V2C file. The vendor generates a new V2C file based on the latest C2V file provided by the end user.

31

HASP_FEATURE_NOT_FOUND

The requested Feature was not found.

 Contact the vendor's technical support. The requested Feature ID is not available.

32

HASP_NO_LOG

Access log is not enabled.

    

33

HASP_LOCAL_COMM_ERR

A communication error occurred between the API and the local Sentinel License Manager.

 Check if the server is running.  

34

HASP_UNKNOWN_VCODE

The vendor code is not recognized by the API library.

   Check the vendor code file provided by Thales.

35

HASP_INVSPEC

An invalid XML login specification was passed to a function.

 Contact the vendor's technical support. Check the login scope parameter.

36

HASP_INV_SCOPE

The XML scope is not valid.

   Check the scope parameter.

37

HASP_TOO_MANY_KEYS

The scope matches too many Sentinel protection keys.

   Use the correct scope parameter.

38

HASP_TOO_MANY_USERS

Too many concurrent user sessions are connected.

 Wait for others to finish using the protected application or contact your sales representative to increase the concurrency count.  

39

HASP_BROKEN_SESSION

A login session was interrupted due to updates to the license.

 Rerun the application after completing the license changes.  

40

HASP_REMOTE_COMM_ERR

A communication error occurred between the local and remote Sentinel License Managers.

 Check the network connectivity and rerun the application.  

41

HASP_FEATURE_EXPIRED

The Feature has expired.

 Contact the vendor's technical support.  

42

HASP_OLD_LM

The existing version of the Sentinel License Manager does not support the API request.

 Upgrade the Sentinel License Manager(RTE).  

43

HASP_DEVICE_ERR

For a Sentinel SL key, an input/output error occurred in the secure storage area.
OR
For a Sentinel HL key, a USB communication error occurred.

 Contact the vendor's technical support. Check with Thales support.

44

HASP_UPDATE_BLOCKED

Update installation is not permitted - the update was already applied.

 This license is already applied to this machine and cannot be reapplied.  

45

HASP_TIME_ERR

System time has been tampered with.

 Contact the vendor's technical support. Check if the system time tampering is performed on the machine.

46

HASP_SCHAN_ERR

Communication error occurred in the secure channel.

 Contact the vendor's technical support.  

47

HASP_STORAGE_CORRUPT

The secure storage area of the Sentinel SL protection key is corrupted.

 Contact the vendor's technical support. Check with Thales support.

48

HASP_NO_VLIB

The customized vendor library (haspvlib_<vendorID>.*) cannot be located.

 Install the RTE.  

49

HASP_INV_VLIB

The vendor library cannot be loaded.

 Contact the vendor's technical support. Check with Thales support.

50

HASP_SCOPE_RESULTS_EMPTY

Unable to locate any Feature that matches the scope.

   Check the scope parameter.

51

HASP_VM_DETECTED

The license does not allow running the application on a virtual machine.

 Contact the vendor's technical support for a license update for a VM enabled license.  

52

HASP_HARDWARE_MODIFIED

The Sentinel SL key is locked to a different machine.

 Contact the vendor's technical support.  

53

HASP_USER_DENIED

Login is denied because of user restrictions.

 Contact your administrator.  

54

HASP_UPDATE_TOO_OLD

Attempting to apply a V2C file that has already been applied.

 Check if this update is already applied.  

55

HASP_UPDATE_TOO_NEW

Attempting to apply V2C files for a Sentinel protection key in the incorrect sequence

 Ensure you install the V2C file in order.  

56

HASP_OLD_VLIB

Your vendor library version is not supported by the current version of the Licensing API.

 Upgrade the vlib (RTE).  

57

HASP_UPLOAD_ERROR

An attempt to check in a file (such as V2C or H2R) using the Admin Control Center failed due to an invalid format.

 Contact the vendor's technical support.  

58

HASP_INV_RECIPIENT

Invalid XML RECIPIENT parameter.

   Check the recipient parameter, which applies to both rehost and detach operations.

59

HASP_INV_ACTION

Invalid XML ACTION parameter.

   Check the action parameter.

60

HASP_TOO_MANY_PRODUCTS

The scope specified in hasp_transfer() does not identify a unique Product.

   Check the action parameter.

61

HASP_INV_PRODUCT

Invalid Product information.

 Contact the vendor's technical support. Check if the license is either a trial type or a remote type.

62

HASP_UNKNOWN_RECIPIENT

The update can only be applied to the Recipient specified in hasp_transfer() and not to this machine.

 Ensure you apply the license to the correct recipient.  

63

HASP_INVALID_DURATION

The duration is invalid.

   Check the duration parameter.

64

HASP_CLONE_DETECTED

Cloned Sentinel SL secure storage area was detected.

 Ensure the license is used on the correct machine.  

65

HASP_UPDATE_ALREADY_ADDED

The specified V2C or or V2CP update was already installed in the License Manager service.

 Check if latest V2C received is being reapplied. Ignore it.

66

HASP_HASP_INACTIVE

The specified key ID identifies an inactive key.

 Contact the vendor's technical support. Check if any V2C files are missing from the end user's machine.

67

HASP_NO_DETACHABLE_FEATURE

No detachable Feature exists.

   Ensure you deliver the detachable license.

68

HASP_TOO_MANY_HOSTS

The specified scope does not identify a unique host.

 Contact the vendor's technical support. Check the scope parameter to ensure it resolves to a unique host.

69

HASP_REHOST_NOT_ALLOWED

Rehost action is not allowed for the specified key ID.

   Ensure that the rehostable license is delivered.

70

HASP_LICENSE_REHOSTED

The original license has been rehosted to another machine.

 The rehost license has already been generated for another machine and cannot be re-applied to the host machine.  

71

HASP_REHOST_ALREADY_APPLIED

An old rehost license cannot be applied. A rehost-counter mismatch occurred.

The rehost license has already been applied to this machine and cannot be applied again.  

72

HASP_CANNOT_READ_FILE

A V2C or V2CP file was not found, or access was denied.

 Contact the vendor's technical support. Check with Thales support.

73

HASP_EXTENSION_NOT_ALLOWED

The license cannot be extended because the number of detached licenses is greater than the number of concurrent licenses allowed.

 While requesting an extension for a detached license, ensure you provide the same concurrency as in the previous detached license.  

74

HASP_DETACH_DISABLED

Detaching the license is not allowed because the Product contains a VM-disabled Feature, and the host machine is a virtual machine.

 Ensure the license is rehosted to a physical machine.  

75

HASP_REHOST_DISABLED

You cannot rehost the license to a virtual machine.

 Ensure the license is rehosted to a physical machine.  
76 HASP_DETACHED_LICENSE_FOUND The user attempted to format an SL-AdminMode key or to migrate an SL-Legacy key to an SL-AdminMode key. However, a Product is currently detached from the key. Cancel the detach operation on the detached licenses and retry this action.  
77 HASP_RECIPIENT_OLD_LM The fingerprint of the target machine was collected using tools (RUS utility or Licensing API) earlier than Sentinel LDK v.7.0. Upgrade the RTE on the target machine to the latest version and regenerate the fingerprint.  
78 HASP_SECURE_STORE_ID_MISMATCH A secure storage ID mismatch occurred. Contact the vendor's technical support.  
79 HASP_DUPLICATE_HOSTNAME

The license is locked to a specific hostname; however, two or more machines with this hostname were found on the network.

 Ensure you remove the machine with the duplicate hostname from the network.  
80 HASP_MISSING_LM The Sentinel License Manager is required for this operation. Install Sentinel LDK License Manager if it is not already installed, and ensure the LM service is up and running.  
81 HASP_FEATURE_INSUFFICIENT_EXECUTION_COUNT

A protected application tried to consume or reserve multiple executions while logging in to a Feature. However, the license does not contain the number of executions that were requested.

 Contact the vendor's technical support for an updated license with the required execution count.  
82 HASP_INCOMPATIBLE_PLATFORM The function is attempting to perform an operation that is not compatible with the target platform. Contact the vendor's technical support with the vendor when this status code appears. Check with Thales support.
83 HASP_HASP_DISABLED

The protection key is disabled due to suspected tampering.

 Share the C2V file with the vendor for appropriate action.  
84 HASP_SHARING_VIOLATION The protection key is not accessible due to a USB sharing violation.    
85 HASP_KILLED_SESSION The session is interrupted due to a network malfunction or is manually interrupted from the Admin Control Center. Restart the application.  
86 HASP_VS_DETECTED The license does not allow installing the application on a virtual machine. Ensure the machine has no virtual storage enabled. Remove the virtual storage to continue using this license.  
87 HASP_IDENTITY_REQUIRED A client identity is required to run this application. The end user raises a technical support issue to obtain the identity string required to perform this operation.  
88 HASP_IDENTITY_UNAUTHENTICATED The client identity is not authenticated. Contact the vendor's technical support.  
89 HASP_IDENTITY_DISABLED The client identity is disabled. Contact your sales representative, as the client identity is disabled.  
90 HASP_IDENTITY_DENIED The client identity does not have the required permissions. Contact your sales representative, as the client does not have the required permissions for the operation.  
91 HASP_IDENTITY_SHARING_VIOLATION Your license is in use on a different machine. Wait for the other session to finish and try again, as a session with this identity string already exists. If the error persists, contact your sales representative.  
92 HASP_IDENTITY_TOO_MANY_MACHINES The maximum number of machines usable by the client identity has been reached. Contact the vendor's technical support.  
93 HASP_IDENTITY_SERVER_NOT_READY (For device-based licenses) The license server is not ready to authenticate. Contact the vendor's technical support.  
94 HASP_ UPDATE_OUT_OF_SYNC

Attempting to install a V2C file with an update counter that is out of sync with the update counter in the Sentinel protection key.

 Share the current C2V file with the vendor and request an updated V2C file. Obtain the current C2V file from the customer and generate a new V2C file.
95 HASP_REMOTE_SHARING_VIOLATION

There were multiple attempts to access the protection key from a remote machine using a proxy.

 Contact the vendor's technical support.  
96 HASP_CLOUD_SESSION_OCCUPIED_REMOTELY

A cloud licensing session was released because the client requested the seat from a different location.

 Contact the vendor's technical support.  
97 HASP_CLOUD_MISSING_AUTHORIZATION

Cloud licensing authorization is required to use this license.

 Contact the vendor's technical support.  
98 HASP_INV_NETWORK_SEATS

Invalid seat value in network detach. The seat count cannot be decreased when modifying a detach.

 While modifying an existing detached license, do not reduce the seats below the already detached seat count. Check the existing detached seat count and update accordingly.  
99 HASP_NETWORK_DETACH_DISABLED

Network detach of seats with concurrency is disabled on a Product with only unlimited-concurrency Features.

 This product includes all features with unlimited concurrency. Network detach is allowed only for features with finite concurrency. Contact your sales representative for an updated product.  
100 HASP_CLOUD_NOT_SUPP

The required functionality is not supported for cloud licenses.

 Contact the vendor's technical support.  
101 HASP_CLOUD_NOT_TRUSTED

Only trusted licenses can be installed in the trusted license storage.

   Ensure the cloud enabled licenses are provided for trusted storage.
102 HASP_CLOUD_STORAGE_COMM_ERR

A communication error occurred with the license storage.

 Ensure stable internet connectivity to the license server or contact your sales representative.  
103 HASP_IDENTITY_EXPIRED The client identity has expired. Contact the vendor's technical support to extend the expiration date for their identity.  
104 HASP_INV_OPTION The option value specified for the API function is not valid. Check the option parameter passed in the hasp_update_session API.  
105 HASP_CLOUD_STORAGE_BUSY The license server is overloaded. Retry the operation in a few seconds. Contact the vendor's technical support or contacts the admin.  
106 HASP_MACHINE_DENIED This machine cannot be used because the fingerprint is invalid or not accessible. Contact the vendor's technical support or contacts the admin.  
107 HASP_MACHINE_DISABLED The application license is not accessible because this machine is disabled. Contact the vendor's technical support or contacts the admin.  
108 HASP_IDENTITY_RATE_LIMIT_EXCEEDED The rate at which identity requests are received exceeded the contracted limit. Try again later. Contact the vendor's technical support or contacts the admin.  
109 HASP_FEATURE_START_DATE_NOT_REACHED The start date for the Feature has not yet arrived. Contact the vendor's technical support or contacts the admin. Notify the user about the feature start date in the application.

110

HASP_IDENTITY_TEMPORARILY_NOT_ACCESSIBLE

The identity is temporarily not accessible. Try again in a few seconds.

 Retry after some time.  

111

HASP_CONFLICTING_AUTHENTICATION_METHODS

You cannot use both an identity string and a JWT for the same server address. Contact the vendor's technical support. Check with Thales support.

112

HASP_ACCESS_TOKEN_IS_INVALID

The JWT or LM access token is invalid. Restart the operation. Contact the vendor's technical support. Check with Thales support.

113

HASP_ACCESS_TOKEN_EXPIRED

The JWT or LM access token has expired. Restart the operation Contact the vendor's technical support. Check with Thales support.

400

HASP_NO_API_DYLIB

Unable to locate the dynamic library for this vendor code.

    

401

HASP_INVALID_API_DYLIB

The dynamic library for this vendor code cannot be loaded, possibly due to corruption.

    

402

HASP_INCOMPLETE_API_DYLIB

The dynamic library for this vendor code is too old, and a requested function was not found.

    

500

HASP_INVALID_OBJECT

Object was incorrectly initialized.

    

501

HASP_INVALID_PARAMETER

An invalid function parameter was specified.

    

502

HASP_ALREADY_LOGGED_IN

Attempting to log in twice to the same object.

    

503

HASP_ALREADY_LOGGED_OUT

Attempting to log out twice from the same object.

    

525

HASP_OPERATION_FAILED

Incorrect use of system or platform.

    

600

HASP_NO_EXTBLOCK

An internal error occurred: No classic memory extension block is available.    

650

HASP_INV_PORT_TYPE

An internal error occurred: Invalid port type.    

651

HASP_INV_PORT

An internal error occurred: Invalid port value.    

698

HASP_NOT_IMPL

The requested functionality is not supported.

    

699

HASP_INT_ERR

An internal error occurred in the API.