QlmLicense.UpdateActivationLogInfo

Updates the data associated with a license key. To use a proxy server, you must set the UseProxyServer, ProxyUser, ProxyDomain and ProxyPassword properties prior to calling this function.

The ActivationLog table is used when multiple licenses are issued from a single ActivationKey. In this case, the data associated with each activated computer is stored in the ActivationLog table instead of the LicenseKeys table. Therefore, to update data in the ActivationLog table, you need to specify which computer to update. The computerID, computerKey and computerName arguments can be specified to identify the computer. At least one of these arguments must be specified.

The ActivationLog table contains the following updatable fields:

ComputerKey, ComputerName, ComputerID, ActivationDate, LastAccessedDate, ActivationCount

Note that to call this function, you must:

• Set the AdminEncryptionKey property

 

Important: The value part of the licenseData xml fragment must be properly escaped for xml reserved keywords.

Example:

string userData = "Test&Go";
userData = SecurityElement.Escape(userData);

string licenseData = String.Format (@"<licenseArguments UserData1=""N'{0}'""> </licenseArguments>", userData);

 

C#:    bool UpdateActivationLogInfo (string webServiceUrl, string activationKey, string computerID, string computerKey, string computerName, string licenseData, out string response)

Parameters

webServiceUrl - URL to the QLM License Server.

activationKey- the license key to udpate

computerID- the ID the computer to udpate

computerKey- the computer bound key to udpate

computerName- the computer name to udpate

licenseData - XML fragment containing the fields to update. The XML fragment should be of the form:

<licenseArguments

field1=" 'value'

field2=" 'value' "

</licenseArguments>

where field1 is the name of a field in the LicenseKeys table. For fields of type date, you should use the following date/time format: yyyy-MM-dd HH:mm:ss

Example:

<licenseArguments

ComputerName= " 'my pc' "

UserData1=" 'my user data' "

</licenseArguments>

 

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>Successfully updated license information for ActivationKey=XYZ.</result>

</QuickLicenseManager>

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>