FB_GetLicenses 1:

The function block reads the valid and invalid TwinCAT licenses.


    bExecute  : BOOL;
    tTimeout  : TIME := DEFAULT_ADS_TIMEOUT;
    sNetId    : T_AmsNetId;

bExecute: The function block is activated by a positive edge at this input.

tTimeout: States the length of the timeout that may not be exceeded by execution of the ADS command.

sNetId: This is the parameter to specify the AmsNetID (type: T_AmsNetID) of the TwinCAT computer, whose current TwinCAT licenses are to be read. If it is to be run on the local computer, an empty string can be entered.


    bBusy      : BOOL;
    bError     : BOOL;
    nErrorId   : UDINT;
    nValidLicenses : UDINT;
    aValidLicenses : ARRAY [1..nMaxLicenses] OF ST_TcOnlineLicenseInfoData;
    nInvalidLicenses : UDINT;
    aInvalidLicenses : ARRAY [1..nMaxLicenses] OF ST_TcOnlineLicenseInfoData;

bBusy: When the function block is activated this output is set. It remains set until a feedback is received.

bError: If an error should occur during the transfer of the command, then this output is set once the bBusy output was reset.

nErrorId: Supplies the ADS error number when the bError output is set.

nValidLicenses: Returns the number of valid TwinCAT licenses.

aValidLicenses: Returns a list of valid TwinCAT licenses of data type ST_TcOnlineLicenseInfodata.

nInvalidLicenses: Returns the number of invalid TwinCAT licenses.

aInvalidLicenses: Returns a list of invalid TwinCAT licenses of data type ST_TcOnlineLicenseInfodata.

FB_GetLicenses 2:

By default, the maximum number of license list entries is 50. This limit can be changed in the parameter list of the library via nMaxLicenses.


Development environment

Target platform

PLC libraries to be integrated (category group)

TwinCAT v3.1.4018

PC or CX (x86, x64, ARM)

Tc2_Utilities (system) v3.3.9.0 or higher