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
Parameter | Type | Description |
---|---|---|
installID | string | unique identifier of this installation, returned by a call to AddInstall |
softwareVersion | string | version of your software |
osVersion | string | version of the operating system |
computerName | string | name of the computer. |
computerID | string | unique computer identifier |
activationKey | string | activation key on the system |
computerKey | string | computer key associated with the system |
trial | bool | flag indicating if the license is a trial |
productName | string | name of your product |
majorVersion | int | major version of your product |
minorVersion | int | minor version of your product |
customData1 | string | your own custom data |
customData2 | string | your own custom data |
customData3 | string | your own custom data |
Return
Type | Description |
---|---|
Boolean | true 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);
}