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

Parameter	Type	Description
webServiceUrl	string	URL to the QLM License Server
activationKey	string	Activation Key of the customer. This argument can be empty if the ComputerKey argument is provided.
computerKey	string	Computer Key of the customer. This argument can be empty if the ActivationKey argument is provided.
productID	int	ID of the product.
majorVersion	int	Major version of the product
minorVersion	int	Minor version of the product.
downloadUrl	out string	returns the url to download the latest version.
notes	out string	returns notes about the latest version.
response	out string	XML fragment containing the result of the call. The Xml fragment schema is as follows:

Return

Type	Description
string	Returns 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
}