VLSucgDecodeLicense

Syntax 

int VLSucgDecodeLicense (VLSucg_HANDLE iHandle, char *AnyLicenseString, char *lic_string, 
			  int lic_string_length, ucodeT **ucodePP );
Argument Description

iHandle

Instance handle for this library.

AnyLicenseString

User provided license string to be decoded.

lic_string

User allocated buffer to receive decoded license string.

lic_string_length

Length of decoded license string returned.

ucodePP

Address of pointer to ucodeT struct. Contains input license string.

Description

VLSucgDecodeLicense API is contained in lsdcod32.lib. This library needs to be called for using the VLSucgDecodeLicense API without the license meter.

Decodes the encrypted license string generated by the upgrade code generator library. It also converts the license string into ucodePP struct.

VLSucgDecodeLicense does not decode the normal (base) licenses.

Returns

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

Error Code Description

VLSucg_INVALID_VENDOR_CODE

If vendor identification is invalid.

VLSucg_VENDOR_ENCRYPTION_ FAIL

If vendor-customized encryption fails.

VLSucg_MALLOC_FAILURE

If an error occurred while allocating internal memory for ucodeT struct.

VLSucg_FAIL

On failure.

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