VLScgSetCodeLength

Syntax

int VLScgSetCodeLength (VLScg_HANDLE iHandle, codeT *codeP, char *flag);
Argument Description

iHandle

The instance handle for this library.

codeP

The pointer to the codeT struct.

flag

The Flag values used to set the code_type member of the codeT struct. Legal values are:

>VLScg_SHORT_CODE_STRING = “0”

>VLScg_LONG_CODE_STRING = “1”

>VLScg_SHORT_NUMERIC_CODE_STRING = “2”

Description

Sets the license code length to short or long.

License codes are 10 characters or longer uppercase alphanumeric or all-numeric strings. The license generator generates long, short, or short-numeric license codes.

>Short code licenses contain less information than the long code and cannot support certain licensing options. However, short codes have the advantage of being easier to generate and manage.

NOTE   Short code licenses are not supported from license version 11 onwards.

>Long codes can contain as many characters as needed.

>Short-numeric codes are numeric strings only and require minimal information from the user. This code contains the least information.

NOTE   Short-numeric code licenses not supported for license earlier than version 6.

Returns

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

Error Code Description

VLScg_INVALID_INPUT

If either codeP or flag are NULL.

VLScg_INVALID_INT_TYPE

Value is not numeric.

VLScg_EXCEEDS_MAX_VALUE

If value exceeds VLScg_SHORT_NUMERIC_CODE.

VLScg_LESS_THAN_MIN_VALUE

If the value is lower than VLScg_SHORT_CODE.

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