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
webServiceUrl
string
URL to the QLM License Server.
fieldName
string
Name of the field used to locate the Activation Key to activate
fieldValue
string
Value of the field used to locate the Activation Key to activate
string
Email address of user that owns the license
computerID
string
The unique computer identifier
computerName
string
The name of the computer. This argument is not required but recommended.
qlmVersion
string
The version of the QLM Engine
userData1
string
User data to associate with the license key
affiliateID
string
ID of affiliate
response
string
XML fragment containing the result of the call. The Xml fragment schema is as follows:
Response XML format
<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<pckey>C06C4C90A497F091C2F080501000C076A0578E</pckey>
<userCompany>My Company</userCompany>
<userFullName>John Smith</userFullName>
<userEmail>[email protected]</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
}
Last updated