WR_LFGetNum

This function can be used to retrieve the values of the numeric variables stored in the license file. You may use any of the User Defined fields to store your own data freely.

Syntax

Visual Basic
Declare Function WR_LFGetNum(ByVal flags As Long, ByVal var_no As Long, ByRef value As Long) As Long
C/C++
LONG WR_LFGetNum(LONG flags, LONG var_no, LPLONG value);

Arguments

flags
Reserved. Set to 0
var_no
Determines which field in the license file for which a value is being retrieved. See the available fields table below.
value
The variable location in which the license file field's value will be stored.

Returns

If the call fails, any of the API Error Codes may be returned.

-2
The application has not been wrapped.
-1
The API is not available. Please check your wizard settings. See the Testing section in the API Setup topic for more information.
1
The the value was successfully retrieved from the license file field and stored in value.

Example

C/C++
//Retrieve the data after activating with Trigger Code 2
long lRetVal = 0;
long data = 0;
lRetVal = WR_LFGetNum(0, 23, &data);

//we can use this data to specify the version of the application (Standard, Pro, Enterprise, etc.)
if (data == 1)
{
//Standard Edition
}
else if (data == 2)
{
//Professional Edition
}

Available Fields

Field ID Description
1 Executions Since Last Update Check
2 Trial Executions Remaining
3 Executions Since Last License Check
4 through 8 Reserved
9 User Defined 1
10 User Defined 2
11 User Defined 3
12 User Defined 4
13 User Defined 5
14 License File Checksum
15 through 21 Reserved
22 Contains the module bit field when using Trigger Code 3 or 4
23 Contains the data when using Trigger Code 2
24 through 27 Reserved
28 Activation License ID
29 Reserved