Set Function

Description

Sets configuration options or applies actions to a License Manager specified by a License Manager context.

Syntax

sntl_admin_status_t  SNTL_ADMIN_CALLCONV sntl_admin_set(
        sntl_admin_context_t  *  admin_context,
        const char *             input,
        char **                  status
        )

Parameters

admin_context

Pointer to the License Manager context to be used

input

Definition of the actions/settings to be done, in XML format. For more information, see Action XML Tags or Changing Configuration Settings for Sentinel License Manager.

status

Pointer to the status information for the applied actions/settings, in XML format

Return Values

SNTL_ADMIN_STATUS_OK

SNTL_ADMIN_INSUF_MEM

SNTL_ADMIN_INVALID_CONTEXT

SNTL_ADMIN_LM_NOT_FOUND

SNTL_ADMIN_LM_TOO_OLD

SNTL_ADMIN_BAD_PARAMETERS

SNTL_ADMIN_LOCAL_NETWORK_ERR

SNTL_ADMIN_CANNOT_READ_FILE

SNTL_ADMIN_PASSWORD_REQUIRED

SNTL_ADMIN_CANNOT_SET_PASSWORD

SNTL_ADMIN_UPDATE_ERROR

SNTL_ADMIN_BAD_VALUE

SNTL_ADMIN_INVALID_PTR

SNTL_ADMIN_NO_INTEGRATED_LM

SNTL_ADMIN_IDENTITY_CODE_CREATION_FAILED

SNTL_ADMIN_IDENTITY_CODE_REQUIRED

SNTL_ADMIN_ISSUED_TO_REQUIRED

SNTL_ADMIN_MAXIMUM_NUMBER_OF_AUTO_REGISTERED_MACHINES_REQUIRED

SNTL_ADMIN_IDENTITY_CODE_DOES_NOT_EXIST

SNTL_ADMIN_IDENTITY_NOTHING_TO_UNREGISTER

Usage Notes

This function can be used to set multiple attributes in a single call. If, for any reason, the update of one of the attributes fails, the function returns an error code. However, the other attributes in the call are updated successfully. To see which attribute was not updated in this case, see the returned status information.

This function allocates memory for the information it retrieves. To release allocated memory resources, use the Free function.

Related Topics

New Function

XML Tags for Admin API Functions

Examples of XML Code for Functions in Admin API

Changing Configuration Settings for Sentinel License Manager