VLScgSetNumSecrets

Syntax

int VLScgSetNumSecrets (VLScg_HANDLE iHandle, codeT *codeP, char *valu);
Argument Description

iHandle

The instance handle for this library.

codeP

The pointer to the codeT struct.

valu

This value sets the number of secrets.

Description

Sets the total number of secrets for the challenge-response mechanism.

Up to seven secret text strings can be specified, each up to twelve characters long. The secrets are encrypted within the license itself, with only the License Manager knowing how to decrypt the secrets. The License Manager will then compute an authentication response when challenged by a client to confirm its identity.

Returns

The status code VLScg_SUCCESS is returned if successful. Otherwise, it will return the following error codes:

Error Code Description

VLScg_INT_TYPE

If value is not numeric.

VLScg_EXCEEDS_MAX_VALUE

If value exceeds VLScg_MAX_NUM_SECRETS.

VLScg_LESS_THAN_MIN_VALUE

If value is lower than 0.

For the complete list of the error codes, refer to License Generation and Revocation Error Codes .