VLSsetMinimumSigningKeyIndex

Syntax

LS_STATUS_CODE VMSWINAPI VLSsetMinimumSigningKeyIndex(
unsigned int	uiMinimumSigningKeyIndex);

Argument	Description
uiMinimumSigningKeyIndex	The minimum signing key index to be present in the license in order to be consumed. The possible values are: >VLS_AES_SIGNING_KEY_INDEX: The signing key index for allowing consumption of licenses of all versions, including the AES encrypted licenses (version 17 and below) and RSA-signed licenses (version 18 and above). This is the default value. >VLS_RSA_SIGNING_KEY_INDEX: The signing key index for restricting consumption to the more secure RSA-signed licenses (version 18 and above).

Argument

Description

uiMinimumSigningKeyIndex

The minimum signing key index to be present in the license in order to be consumed. The possible values are:

>VLS_AES_SIGNING_KEY_INDEX: The signing key index for allowing consumption of licenses of all versions, including the AES encrypted licenses (version 17 and below) and RSA-signed licenses (version 18 and above). This is the default value.

>VLS_RSA_SIGNING_KEY_INDEX: The signing key index for restricting consumption to the more secure RSA-signed licenses (version 18 and above).

Description

Specifies the minimum signing key index. The public/private key pair assigned to a vendor by Thales has a default version of 1 and is known as the signing key index. This can be used for restricting consumption to the more secure RSA-signed licenses.

Call this API before making a license request call.

For more information, refer to the section "Secure Licensing with Sentinel RMS" of the Chapter - Planning Application Licensing in the Sentinel RMS SDK Developer' Guide.

Returns

The status code LS_SUCCESS is returned if successful. Otherwise, a specific error code is returned indicating the reason for failure. For a complete list of the error codes, Licensing Library Error and Result Codes.