GetLatestEligibleVersion

Description

Gets the latest version of the specified product that the user is eligible to. This works in conjunction with the Maintenance Plan feature and the product Release Date property.

A user is eligible to the latest version where the Maintenance Plan Renewal Date is greater than or equal to the product's release date. Note that if the maintenance plan is not enabled, then the latest version is returned based on the provided product ID, major version and minor version.

 string GetLatestEligibleVersion (string webServiceUrl, 
                                  string activationKey, 
                                  string computerKey, 
                                  int productID, 
                                  int majorVersion, 
                                  int minorVersion, 
                                  out string downloadUrl, 
                                  out string notes, 
                                  out string response)

Parameters

ParameterTypeDescription
webServiceUrlstringURL to the QLM License Server
activationKeystringActivation Key of the customer. This argument can be empty if the ComputerKey argument is provided.
computerKeystringComputer Key of the customer. This argument can be empty if the ActivationKey argument is provided.
productIDintID of the product.
majorVersionintMajor version of the product
minorVersionintMinor version of the product.
downloadUrlout stringreturns the url to download the latest version.
notesout stringreturns notes about the latest version.
responseout stringXML fragment containing the result of the call. The Xml fragment schema is as follows:

Return

TypeDescription
stringReturns the value of the latest version.

Response XML format

<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<result>The latest version is xyz.</result>
<latestVersion>xyz</latestVersion>
</QuickLicenseManager>

Example error response

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

<?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
}