Admin API Return Codes

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

No.

Return Code

Description

0

SNTL_ADMIN_STATUS_OK

Request was successfully completed

3

SNTL_ADMIN_INSUF_MEM

System is out of memory

6001

SNTL_ADMIN_INVALID_CONTEXT

The License Manager context is corrupt or contains invalid data

6002

SNTL_ADMIN_LM_NOT_FOUND

The specified License Manager could not be found

6003

SNTL_ADMIN_LM_TOO_OLD

The specified License Manager was found, but it is an earlier version that does not support Sentinel Admin API functions.

6004

SNTL_ADMIN_BAD_PARAMETERS

The XML request code contains errors. See the resulting information XML for details.

6005

SNTL_ADMIN_LOCAL_NETWORK_ERR

An error occurred while the API was initializing the local network interface

6006

SNTL_ADMIN_CANNOT_READ_FILE

An error occurred when attempting to read the file specified by the prefix "file://". The file does not exist or cannot be accessed.

6007

SNTL_ADMIN_SCOPE_ERROR

The scope definition in the <haspscope> block contains an error

6008

SNTL_ADMIN_PASSWORD_REQUIRED

Password is required

6009

SNTL_ADMIN_CANNOT_SET_PASSWORD

Error setting new password

6010

SNTL_ADMIN_UPDATE_ERROR

Error applying an update (see reply for further explanation)

6011

SNTL_ADMIN_LOCAL_ONLY

The specified License Manager was found, but the License Manager is configured to block remote access.

6012

SNTL_ADMIN_BAD_VALUE

An XML element tried to set an illegal value

6013

SNTL_ADMIN_READ_ONLY

When the return status is SNTL_ADMIN_BAD_PARAMETERS, this error code may be delivered in the result XML when trying to set a read-only value. For example:

<config>
<ini_timestamp>1349882141</ini_timestamp>
</config>

 

<admin_response>
<admin_status>
<code>6004</code>
<text>ERROR 6004</text>
<numerrors>1</numerrors>
<error>SNTL_ADMIN_READ_ONLY (6013) in ini_timestamp</error>
</admin_status>
</admin_response>

6014

SNTL_ADMIN_ELEMENT_UNDEFINED

When the return status is SNTL_ADMIN_BAD_PARAMETERS, this error code may be delivered in the result XML when trying to request a non-existent value. For example:

<admin>
<hasp>
<element name="haspid" />
<element name="temperature" />
</hasp>
</admin>

<admin_response>
<hasp>
<haspid>305420012</haspid>
</hasp>
<hasp>
<haspid>1141301516</haspid>
</hasp>
<admin_status>
<code>6004</code>
<text>ERROR 6004</text>
<numerrors>1</numerrors>
<error>SNTL_ADMIN_ELEMENT_UNDEFINED (6014): temperature</error>
</admin_status>
</admin_response>

6015

SNTL_ADMIN_INVALID_PTR

Get function: The format or scope parameter is NULL.

Set function: The input parameter is NULL.

6016

SNTL_ADMIN_NO_INTEGRATED_LM

In standalone Admin API only: Context was created to address the Integrated License Manager (sntl_integrated_lm). However, the Integrated License Manager is only available with the Integrated Admin API.

6017 SNTL_ADMIN_RESULT_TOO_BIG Returned result is too big. Use a scope to narrow the results.
6019 SNTL_ADMIN_SCOPE_RESULTS_EMPTY Unable to locate any items that match the scope.
6022 SNTL_ADMIN_INV_VCODE Invalid Vendor Code was passed.
6034 SNTL_ADMIN_UNKNOWN_VCODE The Vendor Code is not recognized by the API.
6035 SNTL_ADMIN_ENTROPY_SOURCE_FAILED HTTPS initialization failed.
6036 SNTL_ADMIN_INV_CERT The content of certificate passed in the sntl_admin_context_new_scope function is invalid.
6037 SNTL_ADMIN_CERT_VERIFY_FAILED

The LMS verify certificate failed communicate by the sntl_admin_context_new_scope function.

6051

SNTL_ADMIN_CONNECT_MISSING

Connect function is not called.

6052

SNTL_ADMIN_NET_DLL_BROKEN

.NET DLL found broken.

6054 SNTL_ADMIN_IDENTITY_CODE_REQUIRED

The Set function was called to update or delete a client identity or to unregister a machine. However, the identity_code element is not present or contains an empty value.

6055 SNTL_ADMIN_ISSUED_TO_REQUIRED

The Set function was called to create a new client identity. However, the issued_to element is not present or contains an empty value.

6056 SNTL_ADMIN_MAXIMUM_NUMBER_OF_AUTO_REGISTERED_MACHINES_REQUIRED

The Set function was called to create a new client identity. However, the maximum_number_of_auto_registered_machines element is not present or contains an empty value.

6057 SNTL_ADMIN_IDENTITY_CODE_DOES_NOT_EXIST

The Set function was called to perform an update, delete or unregister action for an existing client identity. However, the specified identity_code does not exist in the database.

6058 SNTL_ADMIN_IDENTITY_CODE_CREATION_FAILED An identity code or secret failed to generate.
6059 SNTL_ADMIN_IDENTITY_NOTHING_TO_UNREGISTER The Set function was called to unregister one or more registered machines. However, no machines matched the elements specified in the XML code that provided to the function.
6060

SNTL_ADMIN_INVALID_OBJECT

Object incorrectly initialized.
6061 SNTL_ADMIN_IDENTITY_NOTHING_TO_UPDATE
Nothing to update.
6062 SNTL_ADMIN_TOO_MANY_IDENTITIES Too many identities.
6063 SNTL_ADMIN_LENGTH_TOO_LONG Length of value is too long for the specified field.
6064 SNTL_ADMIN_SCOPE_PARAM_REQUIRED One of scope parameters is required.
6065 SNTL_ADMIN_IDENTITY_DUP_USER_ID Duplicate user ID passed.
6066 SNTL_ADMIN_SESSION_ID_DOES_NOT_EXIST Session ID does not exist.