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 .