Trial License Implementation in Your Application

A trial license implementation is similar to the basic licensing implementation, regardless of whether you are protecting your application using the Sentinel RMS licensing API set or not. You do not need to make any specific changes in your licensing implementation to support a trial license. It is the license generated and deployed that enforces the trial license functionality. In fact, because of this reason an upgrade to a normal license or another trial license requires you to only send a new license code. You do not have to undergo another license implementation cycle, and your customers do not have to re-install the software. For example, the following code snippet displays the basic API functions that are called to support a trial license:

VLSinitialize();
LSRequest(  (unsigned char *)"dummy", 	            
            (unsigned char *)"", 
            (unsigned char *)FEATURE, 	            
            (unsigned char *)VERSION, &units_reqd, 	            
            (unsigned char *)"Requesting license", &challenge, &handle);


LSUpdate(handle,NULL,NULL,NULL,&challenge);
VLS_RELEASE(handle);

However, you can call the following API functions in your application code for specific purposes as described below:

Function Name	Description	Libraries
VLSsetLicensePrecedence	Sets the precedence level of a trial license	The licensing libraries in the topic This library is available to SCL Add-on customers only.
>VLSgetTrialUsageInfo (Traditional API) >sntl_licensing_get_info API SNTL_QUERY_FEATURE_CUMULATIVE_TRIAL_INFO query type (Unified API)	Obtains the usage information (including hours left and days left) for trial features

NOTE   The VLSgetTrialPeriodLeft function is deprecated now and only applicable to trial licenses earlier than Sentinel RMS 8.1. Instead, the VLSgetTrialUsageInfo API function will be used to support the new trial license attributes.

The Unified API-based licensing implementations can use the SNTL_QUERY_FEATURE_CUMULATIVE_TRIAL_INFO query type of sntl_licensing_get_info API to get information about the trial license attributes.