FB_GetLicenses

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

Eingänge

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

Name	Typ	Beschreibung
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout	TIME	Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.
sNetId	T_AmsNetID	AmsNetId (AMS-Netzwerkkennung) des TwinCAT-Rechners, dessen Lizenzstatus ausgelesen werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

Ausgänge

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

Name	Typ	Beschreibung
bBusy	BOOL	Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError	BOOL	Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.
nErrorId	UDINT	Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.
nValidLicenses	UDINT	Liefert die Anzahl der gültigen TwinCAT-Lizenzen.
aValidLicenses	ARRAY OF ST_TcOnlineLicenseInfodata	Liefert eine Liste der gültigen TwinCAT-Lizenzen.
nInvalidLicenses	UDINT	Liefert die Anzahl der ungültigen TwinCAT-Lizenzen.
aInvalidLicenses	ARRAY OF ST_TcOnlineLicenseInfodata	Liefert eine Liste der ungültigen TwinCAT-Lizenzen.

	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