sntl_licensing_install

Library Information

>This API belongs to the Sentinel RMS licensing library.

>The corresponding header is licensing.h.

Description

>Installs the license in the following scenarios:

•In the case of network licensing, the license is installed on the License Manager.

•In the case standalone licensing, the license is installed on a standalone system.

•In the case of commuter licensing, the commuter authorization is installed on an end-user system.

>Installs the Acknowledgment string, generated using the sntl_licensing_transfer API, to return a commuter license. The License Manager reclaims the token after the installation of the Acknowledgment string.

>Installs the Base64 encoded Permission Ticket (named as the License Revocation Request or LRR). Also, returns the Base64 encoded Revocation Ticket (named as the License Revocation Acknowledgement or LRA) as a part of the license revocation workflow.

NOTE   Use sntl_licensing_install API instead of sntl_licensing_install_license, as it is deprecated since the v9.2.0.

Syntax

SNTL_DECLARE(sntl_status_t) sntl_licensing_install  (sntl_licensing_app_context_t   *app_context,
                                                     const char                     *install_data,
                                                     const sntl_licensing_attr_t    *attr,
                                                     char                           **acknowledge);

Argument	Description
app_context [in]	Pointer to the application context object created using sntl_licensing_app_context_new.
install_data [in]	Use this parameter to specify the installation data such as the: >License string for license installation. >Acknowledgment string for returning a commuter license. >License Revocation Request (LRR). It must be Base64 encoded.
attr [in]	Reserved for future use. Use NULL as the value for this argument.
acknowledge [out]	If an LRR was specified using the install_data parameter, this parameter returns the LRA. The LRA is encoded with Base 64. Decode it (from Base 64) before verification.

Returns

The status code SNTL_SUCCESS is returned, if successful. Otherwise, any of the following error code is returned indicating the reason for failure.

For the complete list of error codes, refer to Licensing Library Error and Result Codes.