ActivateLicenseByField

Description

Activates a license key over the internet, binds it to a specific user and returns a computer bound license key.

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

Parameters

Response XML format

<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<pckey>C06C4C90A497F091C2F080501000C076A0578E</pckey>
<userCompany>My Company</userCompany>
<userFullName>John Smith</userFullName>
<userEmail>[e-mail]</userEmail>
</QuickLicenseManager>

Example error response

<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<error>Details about the error</error>
</QuickLicenseManager>

Remarks

You must call DefineProduct before calling this function.

Use ParseResults to interpret the results of the call and load the returned data into an ILicenseInfo object.

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.

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
}