QlmLicense.UpgradeLicense

Connects to the License Server and upgrades a license. You can upgrade the following data associated to a 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 released licenses table.

To use a proxy server, you must set the UseProxyServer, ProxyUser, ProxyDomain and ProxyPassword properties prior to calling this function.

Note that to call this function, you must:

• Set the AdminEncryptionKey property

 

C#:     bool UpgradeLicense (string webServiceUrl, string activationKey, int productID, int majorVersion, int minorVersion, string qlmVersion, int[] features, DateTime dtExpiry, int expiryDuration, out string response)

Http:    hhttp://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>

Example: http://server/qlm/qlmservice.asmxUpgradeLicense?is_avkey=B0739A30F960FAA0FA3045D0560000000&is_productid=1&is_majorversion=1&is_minorversion=0&is_expdate=2008-06-01

Parameters

 

webServiceUrl - URL to the QLM License Server.

activationKey- activation key to update

productID - ID of the product

majorVersion - New major version of the product

minorVersion - New minor version of the product

qlmVersion - Version of the QLM Engine to use.

features - 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.

dtExpiry - Expiry date of the license key

expiryDuration - Expiry duration of the license key

response - XML fragment containing the result of the call. The Xml fragment schema is as follows:

 

<?xml version='1.0' encoding='UTF-8'?>

<QuickLicenseManager>

<result>The license was upgraded...</result>

</QuickLicenseManager>

In the event of an error, the XML fragments returns:

 

<?xml version='1.0' encoding='UTF-8'?>

<QuickLicenseManager>

<error>The activation key is not valid</error>

</QuickLicenseManager>

Return

True if the upgrade was successful.