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.