QlmLicense.ActivateLicenseByField

Activates a license key over the internet, binds it to a specific user and returns a computer bound license key. To use a proxy server, you must set the UseProxyServer, ProxyUser, ProxyDomain and ProxyPassword properties prior to calling this function.

This function can be used to activate a license when the Activation Key is not known. For example, you can use this function to activate a license based on an Order ID. To do so, you set the fieldName argument to "OrderID" and set the fieldValue argument to the value of the Order ID.

By default, the supported fields are: OrderID and ReceiptID.

You can modify the list of supported fields by updating the activationByFieldAllowedFields setting in the QLM License Server's web.config file.

Note that you must call DefineProduct before calling ActivateLicense.

C#:    void ActivateLicenseByField(string webServiceUrl, string fieldName, string fieldValue, string email, string computerID, string computerName, string qlmVersion, string userData1, string affiliateID, out string response)

Parameters

webServiceUrl - URL to the QLM License Server

fieldName - Name of the field used to locate the Activation Key to activate

fieldValue - Value of the field used to locate the Activation Key to activate

email - Email address of user that owns the license

computerID - Unique computer identfier

computerName - Name of computer

qlmVersion - Version of the QLM Engine to use

userData1 - User data to associate with the license key

affiliateID - ID of affiliate

response - XML fragment containing the result of the call. The Xml fragment schema is as follows:

<?xml version='1.0' encoding='UTF-8'?>

<QuickLicenseManager>

<pckey>C06C4C90A497F091C2F080501000C076A0578E</pckey>

<userCompany>My Company</userCompany>

<userFullName>John Smith</userFullName>

<userEmail>john@smith.com</userEmail>

</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>