VLSucgSetUpgradeCode

Syntax

int VLSucgSetUpgradeCode ( VLSucg_HANDLE  iHandle, ucodeT *ucodeP, char *lockCode);
Argument Description

iHandle

Instance handle for this library.

ucodeP

The pointer to ucodeT struct.

lockCode

The locking code to be checked and set.

Description

Sets the value of the base_lock_code member in the ucodeT struct.

This function checks the input variables for their validity and boundary conditions. However, this function does not check the validity of upgrade code.

NOTE   All the validations and matching of base license information with upgrade license information will be done in VLSucgGenerateLicense.

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 ucodeP is passed as NULL.

VLSucg_NO_UPGRADE_ CODE

If the upgrade_code is passed as NULL or empty string.

VLSucg_EXCEEDS_MAX_ VALUE

if value exceeds VLSucg_UPGRADE_ALL.

VLSucg_FAIL

On Failure.

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