FB_GetLicenses
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.
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 |