API Reference

UpdateInstallEx

Description

Updates information of a registered installation on the server.

Note that to call this function, you must initialize the QlmAnalytics object with the following properties:

  • WebServiceUrl
  • CommunicationEncryptionKey
  • GUID (persistence key)
bool UpdateInstallEx(string installID, string softwareVersion, 
                   string osVersion, string computerName, 
                   string computerID, string activationKey, 
                   string computerKey, bool trial, 
                   string productName, 
                   int majorVersion, int minorVersion,
                   string customData1, string customData2, string customData3)

Parameters

ParameterTypeDescription
installIDstringunique identifier of this installation, returned by a call to AddInstall
softwareVersionstringversion of your software
osVersionstringversion of the operating system
computerNamestringname of the computer.
computerIDstringunique computer identifier
activationKeystringactivation key on the system
computerKeystringcomputer key associated with the system
trialboolflag indicating if the license is a trial
productNamestringname of your product
majorVersionintmajor version of your product
minorVersionintminor version of your product
customData1stringyour own custom data
customData2stringyour own custom data
customData3stringyour own custom data

Return

TypeDescription
Booleantrue if the operation was successful; otherwise, false.

Remarks

To instruct the server to not update the value of a custom data field, set the value to null.

Example

// license  is an instance of a QlmLicense object. When using the LicenseValidator class, 
// you should use licenseValidator.QlmLicenseObject.

try
{
  QlmAnalytics analytics = new QlmAnalytics(license);

  string errorMessage;

  string installID = analytics.ReadInstallID(out errorMessage);

  analytics.UpdateInstallEx(installID,
                              version, analytics.GetOperatingSystem(),
                              Environment.MachineName, computerID,
                              activationKey, this.computerKey, license.IsEvaluation(),
                              license.ProductName, license.MajorVersion, license.MinorVersion,
                              "My Custom Data1", null, null
                             );
}
catch (Exception ex)
{
  Console.WriteLine(ex.Message);
}