sntl_lg_generate_license() Function

Description

Generates the license.

Usage Notes

The 'resultant_state' parameter points to the consolidated state. The consolidated state is the expected final state (in XML format) on the end user machine after successful application of license. This state is the result of the current state passed at the time of sntl_lg_start() together with the license definition that was applied up to this point using sntl_lg_start() and sntl_lg_apply_template(). If the consolidated state is saved to a file, the file can used as the C2V file for a future update to the protection key on the end user machine.

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

To reuse the handle again for license definition validation or license generation, call the sntl_lg_start() function with the same handle. The sntl_lg_start() function frees all the resources acquired for the handle and allows license generation on the same handle without calling sntl_lg_initialize().

Syntax

sntl_lg_status_t SNTL_LG_CALLCONV sntl_lg_generate_license ( 
          sntl_lg_handle_t  handle,  
          const char *     generation_param, 
          char **         license, 
          char **         resultant_state 	   
)

Parameters

`handle`	[IN] License generation handle.
`generation_param`	[IN] Reserved for future use. Set this parameter to NULL.
`license`	[OUT] Pointer to the license that is retrieved.
`resultant_state`	[OUT] Pointer to the resultant state. If a current state was not provided in sntl_lg_start(), the resultant state here returns NULL. For example, for license types SNTL_LG_LICENSE_TYPE_PROVISIONAL and SNTL_LG_LICENSE_TYPE_GENERIC_UPDATE, sntl_lg_start() does not accept a current_state.