QlmLicense.GetDataSetEx2

• You must set the AdminEncryptionKey property before calling this function.
• This function is only available to QLM Enterprise customers.

C#:    void GetDataSetEx (string webServiceUrl, string table, string filter, int maxRecords, string distinctFieldValue, string uniqueIDField, ref string dataSet, out string response)

Parameters

webServiceUrl - URL to the QLM License Server.

table- specify the table to query. The possible value are:

• qryLicenseInfo: the main table where all license keys are recorded.
• qryActivationLog:  the table containing the activation log for multiple activations keys.
• qryLicenseHistoryInfo: the table containing historical keys.
• qryAnalyticsInstalls: the table containing Analytics.
• qryActivationAttempts: the table containing the activation attempts.
• qryIllegalComputers: the table containing the illegal computers.

filter - SQL filter to determine which records to return. Use a where clause sql syntax, example: ActivationKey='AAAA'. Note that if the filter contains an Activation Key or a Computer Key, you must strip out the dashes in the license key. License keys in the database are stored without dashes.

maxRecords: the maximum number of records to return. Set the value to -1 to return all records.

distinctFieldValue: Name of a field whose value should be distinct in the returned records

uniqueIDField: Name of a field that will be used to identify which record to return when multiple records have the same value in the specified distinctField.

dataSet - returned dataset containing license key records that match criteria

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 executed query using filter...</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>