FB_GetLicensesEx

Der Funktionsbaustein FB_GetLicensesEx ermittelt den Status aller TwinCAT-3-Lizenzen und OEM-Lizenzen.

Eingänge

VAR_INPUT
    bExecute  : BOOL;
    tTimeout  : TIME;
    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_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
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 Lizenzen.
aValidLicenses	ARRAY OF ST_TcOnlineLicenseInfoDataEx	Liefert eine Liste der gültigen Lizenzen.
nPendingLicenses	UDINT	Anzahl noch offener Lizenzen
aPendingLicenses	ARRAY OF ST_TcOnlineLicenseInfoDataEx	Informationen zu den noch offenen Lizenzen
nDemoLicenses	UDINT	Anzahl gültiger Demolizenzen
aDemoLicensese	ARRAY OF ST_TcOnlineLicenseInfoDataEx	Informationen zu den gültigen Demolizenzen
nOemLicenses	UDINT	Anzahl gültiger OEM-Lizenzen
aOemLicenses	ARRAY OF ST_TcOnlineLicenseInfoDataEx	Informationen zu den gültigen OEM-Lizenzen
nFailedLicenses	UDINT	Anzahl fehlgeschlagener Lizenzen
aFailedLicenses	ARRAY OF ST_TcOnlineLicenseInfoDataEx	Informationen zu den gültigen 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
TwinCAT v3.1.4022	PC oder CX (x64, x86)	Tc2_Utilties >= 3.3.24.0