FB_GetLicensesEx 1:

The function block FB_GetLicensesEx determines the status of all TwinCAT 3 licenses and OEM licenses.


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

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

tTimeout: Timeout time that must not be exceeded when the command is executed.

sNetId: AmsNetId (AMS network identifier) of the TwinCAT computer whose license status is to be read (type: T_AmsNetId). 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_TcOnlineLicenseInfoDataEx
    nPendingLicenses : UDINT
    aPendingLicenses : ARRAY[1..nMaxLicenses} OF ST_TcOnlineLicenseInfoDataEx
    nDemoLicenses    : UDINT
    aDemoLicenses    : ARRAY[1..nMaxLicenses} OF ST_TcOnlineLicenseInfoDataEx
    nOemLicenses     : UDINT
    aOemLicenses     : ARRAY[1..nMaxLicenses} OF ST_TcOnlineLicenseInfoDataEx
    nFailedLicenses  : UDINT
    aFailedLicenses  : ARRAY[1..nMaxLicenses} OF ST_TcOnlineLicenseInfoDataEx
    nInvalidLicenses : UDINT
    aInvalidLicenses : ARRAY[1..nMaxLicenses} OF ST_TcOnlineLicenseInfoDataEx

bBusy: TRUE, as long as the function block is active.

bError: TRUE if an error occurs during command execution.

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

nValidLicenses: Number of valid licenses

aValidLicenses: Information on valid licenses

nPendingLicenses: Number of open licenses

aPendingLicenses: Information on outstanding licenses

nDemoLicenses: Number of valid demo licenses

aDemoLicenses: Information on valid demo licenses

nOemLicenses: Number of valid OEM licenses

aOemLicenses: Information on valid OEM licenses

nFailedLicenses: Number of failed licenses

aFailedLicenses: Information on valid licenses

nInvalidLicenses: Number of invalid licenses

aInvalidLicenses: Information on invalid licenses


Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.4022

PC or CX (x64, x86)

Tc2_Utilties >=