sntl_lg_apply_template() Function

Description

Applies a license definition to the license state associated with the handle.

Usage Notes

Call this function after sntl_lg_start(). You can call this function as many times as needed in order to introduce changes in the license state through license definition parameters. (See License Definition Example.) For example: You can define a Product in an initial license definition and then call sntl_lg_apply_template as many times as necessary to add Features, Feature attributes, other Products, or protection key memory to the license state.

This function validates the input license definition with respect to the current state of the license associated with the handle. Only a valid license definition will be applied to the license state associated with the handle.

Syntax

sntl_lg_status_t SNTL_LG_CALLCONV sntl_lg_apply_template (
sntl_lg_handle_t *  handle,
const char *      license_definition
)

Parameters

handle

[IN] License generation handle.

license_definition

[IN] Definition of the license to be introduced.

For more information on XML tags for license definition, see License Definition Input XML Templates.

Return Values

SNTL_LG_STATUS_OK

SNTL_LG_LIB_INITIALIZATION_FAILED

SNTL_LG_RESOURCE_LOCK_FAILURE

SNTL_LG_OUT_OF_MEMORY

SNTL_LG_INVALID_HANDLE

SNTL_LG_INVALID_PARAMETER

SNTL_LG_INVALID_API_CALL_SEQUENCE

SNTL_LG_INVALID_LICENSE_DEFINITION

SNTL_LG_INVALID_SCHEMA_VERSION

SNTL_LG_DAYS_TO_EXPIRATION_NOT_SUPPORTED

SNTL_LG_EXPIRY_DATE_NOT_SUPPORTED

SNTL_LG_UNLIMITED_CONCURRENCY_COUNT_NOT_SUPPORTED

SNTL_LG_CONCURRENCY_NOT_SUPPORTED

SNTL_LG_TOO_BIG_RO_MEM_DATA

SNTL_LG_TOO_BIG_RW_MEM_DATA

SNTL_LG_EXCEEDING_MAX_CONCURRENCY_COUNT_LIMIT

SNTL_LG_EXCEEDING_MAX_EXECUTION_COUNT_LIMIT

SNTL_LG_EXCEEDING_MAX_EXPIRY_DATE_LIMIT

SNTL_LG_BELOW_MIN_EXPIRY_DATE_LIMIT

SNTL_LG_INCOMPATIBLE_ENFORCEMENT_TYPE

SNTL_LG_INTERNAL_ERROR

SNTL_LG_OLD_FIRMWARE

SNTL_LG_DYNAMIC_RESOURCE_NOT_SUPPORTED

Related Topics

sntl_lg_initialize()

sntl_lg_start()

License Definition Input XML Templates

License Definition Example