VLScgSetFeatureName

Syntax 

int VLScgSetFeatureName (VLScg_HANDLE iHandle, codeT *codeP, char *info);
Argument Description

iHandle

The instance handle for this library.

codeP

The pointer to the codeT struct.

info

Any printable ASCII text.

Description

A feature name can represent a single executable file, multiple executable files, or a portion (a function) of an executable file.

A feature name may be a maximum of:

>11 ASCII characters for short license codes

>24 ASCII characters for long license codes

>Two ASCII characters for short-numeric license codes and multi-feature license codes.

All applications must have a feature name to be identified.

NOTE   You cannot use the following characters, as these are reserved for internal usage:

>Space (ASCII value 32)

>! (ASCII value 33)

># (ASCII value 35)

>$ (ASCII value 36)

For guidelines regarding reserved characters and strings, refer to License Generation API Reference Guide.

Returns

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

Error Code Description

VLScg_NO_FEATURE_NAME

If the info is NULL.

VLScg_RESERV_STR_ERR

If the info is a reserved string.

VLScg_INVALID_CHARS

If the info characters are not printable.

VLScg_EXCEEDS_MAX_STRLEN

If the length of info passed exceeds the maximum length of 24.

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