FB_CheckLicense
If you use OEM licenses make sure you encrypt your boot project! Remember that the license ID queried via FB_CheckLicense in the binary code can easily be found and (with a little effort) manipulated with a hex editor. Therefore, be sure to encrypt your boot project (safest), or at least disguise the queried license ID in the source code as best as possible. |
The function block FB_CheckLicense determines the TwinCAT 3 license status for a given license ID.
Inputs
VAR_INPUT
bExecute : BOOL;
tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
sNetId : T_AmsNetId;
stLicenseId : GUID;
END_VAR
Name | Type | Description |
---|---|---|
bExecute | BOOL | The function block is enabled by a positive edge at this input. |
tTimeout | TIME | States the length of the timeout that may not be exceeded by execution of the ADS command. |
sNetId | T_AmsNetID | AmsNetId (AMS network identifier) of the TwinCAT computer whose license status is to be read. For the local computer an empty string may be specified. |
stLicenseId | License ID |
Outputs
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrId : UDINT
stCheckLicense : ST_CheckLicense;
END_VAR
Name | Type | Description |
---|---|---|
bBusy | BOOL | When the function block is enabled, this output is set and remains set until a feedback is received. |
bError | BOOL | If an error occurs during the transmission of the command, this output is set after the bBusy output is reset. |
nErrId | UDINT | Returns the ADS error number when the bError output is set. |
stCheckLicense | Structure with license data |
Requirements
Development environment | Target platform | PLC libraries to include |
---|---|---|
TwinCAT v3.1.4022 | PC or CX (x64, x86) | Tc2_Utilties >= 3.3.24.0 |