VLSucgSetUpgradeFlag

Syntax

int VLSucgSetUpgradeFlag ( VLSucg_HANDLE  iHandle, ucodeT *ucodeP, char *flag );
Argument Description

iHandle

Instance handle for this library.

ucodeP

The pointer to ucodeT struct.

flag

The value of the flag is used to set the upd_flags of ucodeT struct. Legal values are bit combinations of

>VLSucg_UPGRADE_VERSION

>VLSucg_UPGRADE_CAPACITY

>VLSucg_UPGRADE_ALL

Description

Sets the value of upd_flags in the ucodeT struct. This function also checks the input variables for their validity and boundary conditions.

>If the flag value is VLSucg_UPGRADE_VERSION then only version upgrade license can be generated.

>If the flag value is VLSucg_UPGRADE_CAPACITY then only capacity upgrade license can be generated.

>If the flag value is VLSucg_UPGRADE_ALL then both version and capacity upgrade license can be generated.

Returns

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

Error Code Description

VLSucg_INVALID_INPUT

If the either the ucodeP or flag is passed as NULL. Also, if the flag is passed as an empty string.

VLSucg_INVALID_INT_TYPE

If value of the flag is not numeric.

VLSucg_EXCEEDS_MAX_ VALUE

If value of the flag exceeds VLSucg_UPGRADE_ALL

VLSucg_LESS_THAN_MIN_ VALUE

If value of the flag is lower than VLSucg_UPGRADE_VERSION.

For the complete list of the error codes, refer to Upgrade License Error Codes.