FB_GetLicenses

FB_GetLicenses 1:

Der Funktionsbaustein liest die gültigen und ungültigen TwinCAT-Lizenzen aus.

VAR_INPUT

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

bExecute: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

tTimeout: Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

sNetId: Hier kann die AmsNetId (Typ: T_AmsNetID) des TwinCAT-Rechners angegeben werden, dessen aktuelle TwinCAT-Lizenzen ausgelesen werden sollen. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

VAR_OUTPUT

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

bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError: Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.

nErrorId: Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.

nValidLicenses: Liefert die Anzahl der gültigen TwinCAT-Lizenzen.

aValidLicenses: Liefert eine Liste der gültigen TwinCAT-Lizenzen vom Datentyp ST_TcOnlineLicenseInfodata.

nInvalidLicenses: Liefert die Anzahl der ungültigen TwinCAT-Lizenzen.

aInvalidLicenses: Liefert eine Liste der ungültigen TwinCAT-Lizenzen vom Datentyp ST_TcOnlineLicenseInfodata.

FB_GetLicenses 2:

Die Lizenzlisten beinhalten standardmäßig maximal 50 Einträge. Diese Grenze kann in der Parameterliste der Bibliothek über nMaxLicenses angepasst werden.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS-Bibliotheken (Kategoriegruppe)

TwinCAT v3.1.4018

PC oder CX (x86, x64, ARM)

Tc2_Utilities (System) v3.3.9.0 oder höher