Log In

UpgradeLicenseEx

Description

Upgrades a license. You can upgrade the following data associated with the license:

  • Features associated to a license
  • Expiry date of the license
  • Duration of the license
  • Major and Minor version of the product
  • The version of the QLM Engine used to generate the license key

When a license is upgraded, a new license key is generated and replaces the existing one. The old license is copied to the History table.

Note that to call this function, you must:

  • Set the AdminEncryptionKey
bool UpgradeLicense (string webServiceUrl, string activationKey, 
                     int productID, int majorVersion, int minorVersion, 
                     string qlmVersion, string features, 
                     DateTime dtExpiry, int expiryDuration, 
                     string comment, 
                     out string newActivationKey, out string response)
http://server/qlm/qlmservice.asmx/UpgradeLicense?is_avkey=<activationKey>&is_productid=<pid>&is_majorversion=<majorVersion>&is_minorversion=<minorVersion>&is_expdate=<yyyy-mm-dd>&is_expdate>&is_expduration=<expiry duration>

Parameters

ParameterTypeDescription
webServiceUrlstringURL to the QLM License Server.
activationKeystringthe current activation key
productIDintID of the product
majorVersionintnew major version of the product
minorVersionintnew minor version of the product
qlmVersionstringversion of the QLM Engine to use.
featuresint[]an array of feature sets specifying the features that should be enabled in the created key. Each feature has a unique feature set and ID associated to it. To combine features, perform a bitwise OR operation on the required features.
dtExpiryDateTimeexpiry date of the license key
expiryDurationintexpiry duration of the license key
commentstringupdate the comment associated with this license.
responsestringXML fragment containing the result of the call

Return

TypeDescription
boolreturns true if the operation succeeded; false otherwise.

Response XML format

<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<result>The license was upgraded...</result>
</QuickLicenseManager>

Example error response

<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<error>Details about the error</error>
</QuickLicenseManager>

Remarks

Use ParseResults to interpret the results of the call and load the returned data into an ILicenseInfo object.

ILicenseInfo li = new LicenseInfo();
string message = string.Empty;
if (lv.QlmLicenseObject.ParseResults(response, ref li, ref message))
{
  // The operation  was successful	
}
else
{
  // The operation failed
}