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 or trace 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

 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 AP

 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 was interrupted due to a network malfunction or was 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 identity-based licenses) The 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