Sentinel Licensing API Status Codes

Package: Aladdin

You can retrieve the return code for the last method called with the getLastError method.

No. Status Code Description

0

HASP_STATUS_OK

Request was successfully completed

1

HASP_MEM_RANGE

Request exceeds the Sentinel protection key memory range

2

HASP_INV_PROGNUM_OPT

Legacy HASP HL Run-time API: Unknown/Invalid Feature ID option

3

HASP_INSUF_MEM

System is out of memory

4

HASP_TMOF

Too many open sessions exist

5

HASP_ACCESS_DENIED

Access to Feature was denied

6

HASP_INCOMPAT_FEATURE

Legacy decryption method cannot work on Feature

7

HASP_HASP_NOT_FOUND

Sentinel protection key is no longer available

8

HASP_TOO_SHORT

Encrypted/decrypted data length too short to execute method call

9

HASP_INV_HND

Invalid handle was passed to method

10

HASP_INV_FILEID

Specified File ID is not recognized by API

11

HASP_OLD_DRIVER

Installed driver is too old to execute method

12

HASP_NO_TIME

Real-time clock (RTC) not available

13

HASP_SYS_ERROR

Generic error from host system call

14

HASP_NO_DRIVER

Required driver is not installed

15

HASP_INV_FORMAT

File format for update is not recognized

16

HASP_REQ_NOT_SUPP

Unable to execute method in this context

17

HASP_INV_UPDATE_OBJ

Binary data that was passed to method does not contain an update

18

HASP_KEYID_NOT_FOUND

Sentinel protection key was not found

19

HASP_INV_UPDATE_DATA

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

20

HASP_INV_UPDATE_NOTSUPP

Update request is not supported by Sentinel protection key

21

HASP_INV_UPDATE_CNTR

Update counter is not set correctly

22

HASP_INV_VCODE   

Invalid Vendor Code was passed

23

HASP_ENC_NOT_SUPP

Sentinel protection key does not support encryption type

24

HASP_INV_TIME

The time value that was passed is outside the supported value range

25

HASP_NO_BATTERY_POWER

The real-time clock battery has run out of power

26

HASP_NO_ACK_SPACE

Acknowledge data that was requested by the update ack_data parameter is NULL

27

HASP_TS_DETECTED

Program is running on a terminal server

28

HASP_FEATURE_TYPE_NOT_IMPL

Requested Feature type is not implemented

29

HASP_UNKNOWN_ALG

Unknown algorithm used in V2C or V2CP file

30

HASP_INV_SIG

Signature verification operation failed

31

HASP_FEATURE_NOT_FOUND

Requested Feature not found

32

HASP_NO_LOG

Access log not enabled

33

HASP_LOCAL_COMM_ERR

Communication error occurred between the API and the local Sentinel License Manager

34

HASP_UNKNOWN_VCODE

Vendor Code is not recognized by API

35

HASP_INVSPEC

Invalid XML specification exists

36

HASP_INV_SCOPE

Invalid XML scope exists

37

HASP_TOO_MANY_KEYS

Too many Sentinel protection keys are currently connected

38

HASP_TOO_MANY_USERS

Too many users are currently connected

39

HASP_BROKEN_SESSION

Session was interrupted.

This can occur when certain updates are applied to the license while a session is active. For example:

>A Feature required by the session was deleted.

>The license was canceled.

>The network (remote license) support setting for a required Feature was changed. (In this case, all sessions will be interrupted, including local sessions.)

This may also indicate that the protection key is not available or that the user is attempting to bypass the application protection by using a protection key emulator.

40

HASP_REMOTE_COMM_ERR

Communication error occurred between local and remote Sentinel License Managers

41

HASP_FEATURE_EXPIRED

Feature has expired

42

HASP_OLD_LM

Sentinel License Manager version is too old. Update Sentinel Run-time Environment to the latest version.

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

44

HASP_UPDATE_BLOCKED

Update installation not permitted

45

HASP_TIME_ERR

System time has been tampered with

46

HASP_SCHAN_ERR

Communication error occurred in the secure channel

47

HASP_STORAGE_CORRUPT

Corrupt data exists in secure storage area of Sentinel protection key

48

HASP_NO_VLIB

The customized vendor library (haspvlib.vendorID.*) cannot be located

49

HASP_INV_VLIB

Unable to load Vendor library

50

HASP_SCOPE_RESULTS_EMPTY

Unable to locate any Feature that matches the scope

51

HASP_VM_DETECTED

Protected application is running on a virtual machine, but one or more Features are not enabled for virtual machines.
OR
The user attempted to rehost a protection key from a physical machine to a virtual machine. However, none of the Features contained in the protection key are enabled for virtual machines.

52

HASP_HARDWARE_MODIFIED

Sentinel SL key incompatible with machine hardware. Sentinel SL key locked to different hardware.
OR
In the case of a V2C or V2CP file, conflict between Sentinel SL key data and machine hardware data. Sentinel SL key locked to different hardware.

53

HASP_USER_DENIED

Login denied because of user restrictions

54

HASP_UPDATE_TOO_OLD

Trying to install a V2C or V2CP file with an update counter that is out of sequence with update counter in the Sentinel protection key. Values of update counter in file are lower than those in Sentinel protection key.

55

HASP_UPDATE_TOO_NEW

Trying to install a V2C or V2CP file with an update counter that is out of sequence with the update counter in the Sentinel protection key. The gap between the first value in the file and the value in Sentinel protection key is greater than 1.

56

HASP_OLD_VLIB

Vendor library is too old

57

HASP_UPLOAD_ERROR

Check in of a file (such as  V2C, H2R) using Admin Control Center failed, possibly because of illegal format

58

HASP_INV_RECIPIENT

Invalid XML RECIPIENT parameter

59

HASP_INV_ACTION

Invalid XML action parameter

60

HASP_TOO_MANY_PRODUCTS

The scope specified in the Transfer method does not specify a unique Product

61

HASP_INV_PRODUCT

Invalid Product information

62

HASP_UNKNOWN_RECIPIENT

Update can only be applied to recipient machine specified in the Detach method, not to this machine

63

HASP_INVALID_DURATION

Invalid detached license duration period specified. Duration must be less than or equal to maximum allowed for this license.
OR
Duration extension is to a date earlier than the expiration date of the current detached license.

64

HASP_CLONE_DETECTED

Cloned Sentinel SL storage was detected. Feature is unavailable.

65

HASP_UPDATE_ALREADY_ADDED

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

66

HASP_HASP_INACTIVE

Specified Key ID is in Inactive state

67

HASP_NO_DETACHABLE_FEATURE

No detachable Feature exists in the specified key from which the detached license is requested

68

HASP_TOO_MANY_HOSTS

The specified scope does not specify a unique host

69

HASP_REHOST_NOT_ALLOWED

Rehost action is not allowed for the specified Key  ID

70

HASP_LICENSE_REHOSTED

Original license has been transferred to another machine. Therefore, the license cannot be returned to the source machine.

71

HASP_REHOST_ALREADY_APPLIED

Old rehost license cannot be applied. A rehost-counter mismatch occurred

72

HASP_CANNOT_READ_FILE

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

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

74

HASP_DETACH_DISABLED

The user attempted to detach a Product from a network license hosted on a virtual machine. However, none of the Features included in the Product are enabled for virtual machines.

75

HASP_REHOST_DISABLED

The user attempted to rehost a protection key from a virtual machine. However, none of the Features contained in the protection key are enabled for virtual machines.

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.
77 HASP_RECIPIENT_OLD_LM For a rehost operation: The fingerprint of the target machine was collected using tools (RUS utility or Licensing API) earlier than Sentinel LDK v.7.0.
78 HASP_SECURE_STORE_ID_MISMATCH A secure storage ID mismatch occurred
79 HASP_DUPLICATE_HOSTNAME

The license fingerprint is bound to a specific hostname; however, two or more machines with this hostname were found in the network. As a result, the license cannot be used.

80 HASP_MISSING_LM A protected application tried to log in to a Feature that supports concurrency on a Sentinel HL (Driverless configuration) key. The Sentinel LDK License Manager service is not active on the computer where the key is located.
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.

82 HASP_INCOMPATIBLE_PLATFORM The function is attempting to perform an operation that is not compatible with the target platform
83 HASP_HASP_DISABLED

A Sentinel HL (Driverless configuration) key was disabled because a user attempted to tamper with the key or with the protected application

84 HASP_SHARING_VIOLATION An HL key is being shared by the use of a USB splitter device (such as Smart X). When this error occurs, a "sharing violation" message is also displayed on the relevant page in Admin Control Center.
85 HASP_KILLED_SESSION The session was interrupted manually from Admin Control Center or was interrupted due a network malfunction
86 HASP_VS_DETECTED The function detected that the operation is being performed in virtual storage. The machine is using computer restoration software.
87 HASP_IDENTITY_REQUIRED (For identity-based licenses) An identity string is required
88 HASP_IDENTITY_UNAUTHENTICATED (For identity-based licenses) The identity string is not authenticated
89 HASP_IDENTITY_DISABLED (For identity-based licenses) The identity string is disabled
90 HASP_IDENTITY_DENIED (For identity-based licenses) The client identity does not have enough permission for the operation
91 HASP_IDENTITY_SHARING_VIOLATION (For identity-based licenses) The session was killed because the identity string used to create the session was acquired by another machine.
92 HASP_IDENTITY_TOO_MANY_MACHINES (For identity-based licenses) The maximum number of machines to which the identity string can be assigned was reached
93 HASP_IDENTITY_SERVER_NOT_READY (For identity-based licenses) The option to store identity secrets with encryption was selected in Admin Control Center, but the authentication key was not yet defined (using Sentinel Admin API).
94 HASP_ UPDATE_OUT_OF_SYNC

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

The vendor should obtain a new C2V file from the customer and then generate a new V2C file.

95 HASP_REMOTE_SHARING_VIOLATION

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

The user is attempting to access a license that does not support concurrency from a remote machine, using a proxy to make the remote machine appear as local.

96 HASP_CLOUD_SESSION_OCCUPIED_REMOTELY

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

97 HASP_CLOUD_MISSING_AUTHORIZATION

Cloud licensing authorization is required to use this license

98 HASP_INV_NETWORK_SEATS

Invalid seat value in detach of seats with concurrency. Seat count cannot be decreased when modifying a detach

99 HASP_NETWORK_DETACH_DISABLED

Detach of seats with concurrency is disabled on a Product with only unlimited-concurrency features

100 HASP_CLOUD_NOT_SUPP

The requested cloud functionality is not supported

101 HASP_CLOUD_NOT_TRUSTED

Only a vendor who satisfied the documented requirements can install a license in trusted license storage

102 HASP_CLOUD_STORAGE_COMM_ERR

A communication error occurred with the license storage

103 HASP_IDENTITY_EXPIRED The client identity has expired
104 HASP_INV_OPTION The option value specified for hasp_updateSession is not valid
105 HASP_CLOUD_STORAGE_BUSY The license server is overloaded. The user should retry the operation in a few seconds.
106 HASP_MACHINE_DENIED Login denied because the fingerprint cannot be fetched from this machine or the fingerprint fetched from this machine is not in the correct format
107 HASP_MACHINE_DISABLED Login denied because this machine is disabled
108 HASP_IDENTITY_RATE_LIMIT_EXCEEDED The rate at which identity requests are received exceeds the contracted limit.
109 HASP_FEATURE_START_DATE_NOT_REACHED Login denied because feature start date not yet reached.

110

HASP_IDENTITY_TEMPORARILY_NOT_ACCESSIBLE

(For identity-based licenses) The identity string is currently not accessible because the server received too many requests to access the license. This is a temporary condition. The user should retry later.

111

HASP_CONFLICTING_AUTHENTICATION_METHODS

You cannot use both an identity string and a JWT for the same server address.

112

HASP_ACCESS_TOKEN_IS_INVALID

The JWT or LM access token is invalid. Restart the operation.

113

HASP_ACCESS_TOKEN_EXPIRED

The JWT or LM access token has expired. Restart the operation.

400

HASP_NO_API_DYLIB

Unable to locate dynamic library for API

401

HASP_INVALID_API_DYLIB

Dynamic library for API is invalid

402

HASP_INCOMPLETE_API_DYLIB

Requested function was not found
OR
In the case of the API Dispatcher, API DLL is too old

500

HASP_INVALID_OBJECT

Object was incorrectly initialized

501

HASP_INVALID_PARAMETER

Scope string is too long (maximum length is 32 KB)

502

HASP_ALREADY_LOGGED_IN

Logging in twice to same object

503

HASP_ALREADY_LOGGED_OUT

Logging out twice from same object

525

HASP_OPERATION_FAILED

Incorrect use of system or platform

600

HASP_NO_EXTBLOCK

Internal error occurred: No classic memory extension block available

650

HASP_INV_PORT_TYPE

Internal error occurred: Invalid port type

651

HASP_INV_PORT

Internal error occurred: Invalid port value

698

HASP_NOT_IMPL

Requested function was not implemented
OR
In the case of the API Dispatcher, API DLL is too old

699

HASP_INT_ERR

Internal error occurred in the API