API Reference

CreateComputerBoundTrialKey

Description

Creates a trial activation key, then automatically activates it on the server side and returns the computer bound license key.

 string CreateComputerBoundTrialKey(string webServiceUrl, 
                                    string computerID, 
                                    string computerName, 
                                    string email, 
                                    string features, 
                                    string affiliateID, 
                                    string userData1, 
                                    out string response)


Parameters

ParameterTypeDescription
webServiceUrlstringURL to the QLM License Server
computerIDstringUnique identifier of the computer being activated.
computerNamestringFriendly name of the computer being activated.
emailstringemail address to associate to the license key - may be empty
featuresstringSemi comma separated list of feature sets and their corresponding values. Example: 0:1;1:2;2:3;3:6 - enables feature 1 in feature set 0, feature 2 in feature set 1, feature 1+2 (3) in feature set 4 and features 1+2+3 (6) in feature set 3.
affiliateIDstringID of affiliate
userData1stringuser data to associate to this license
responsestringXML 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>

Return

TypeDescription
stringthe computer bound license key (ComputerKey)

Remarks

You must call DefineProduct before calling this function.

This function is useful if you want to create trial keys from within your application. The trial period is controlled by the trialDuration Server Property. Server Properties can be set from the Manage Keys / Sites / Server Properties page.

If you want to prevent calls to this function, set the enableCreateComputerBoundTrial Server Property to false. The Server Properties can be set from the Manage Keys / Sites / Server Properties page.

Example

QLM.LicenseValidator licenseValidator = new QLM.LicenseValidator();
string response = string.Empty;
string webServiceUrl = "https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx";

string activationKey = string.Empty;
string computerKey = string.Empty;

lv.QlmLicenseObject.ReadKeys(ref activationKey, ref computerKey);

if (String.IsNullOrEmpty(activationKey) && String.IsNullOrEmpty(computerKey))
{

    computerKey = lv.QlmLicenseObject.CreateComputerBoundTrialKey(webServiceUrl,         Environment.MachineName, Environment.MachineName, "None", string.Empty, string.Empty, string.Empty, out response); 

    string message = string.Empty;
    ILicenseInfo licenseInfo = new LicenseInfo();
    if (lv.QlmLicenseObject.ParseResults (response, ref licenseInfo, ref message))
    {
        string activationKey = licenseInfo.ActivationKey;
        string computerKey = licenseInfo.ComputerKey;
        lv.QlmLicenseObject.StoreKeys(activationKey, computerKey);
    }

}