FB_GetAdaptersInfoEx

FB_GetAdaptersInfoEx 1:

Mit diesem Funktionsbaustein können Adapterinformationen eines TwinCAT PCs ausgelesen werden. Die maximale Anzahl der gelesenen Adapterinformationen ist auf 64 begrenzt.

Nach einem erfolgreichen Aufruf ist der Lesevorgang beendet und die gelesenen Adapterinformationen können mittels der Methode Get() kopiert werden.

FB_GetAdaptersInfoEx 2: Eingänge

VAR_INPUT
    sNetID    : T_AmsNetID;
    bExecute  : BOOL;
    tTimeout  : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Name

Typ

Beschreibung

sNetID

T_AmsNetID

Hier kann ein String mit der Netzwerkadresse des TwinCAT-Rechners angegeben werden, dessen Adapterinformationen gelesen werden sollen. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

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.

FB_GetAdaptersInfoEx 3: Ausgänge

VAR_OUTPUT
    bBusy       : BOOL;
    bError      : BOOL;
    nErrorID    : UDINT;
    nAdapters   : UINT;
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.

nAdapters

UDINT

Anzahl der gefundenen lokalen Adapter. Deren Adapterinformationen wurden ausgelesen und können mittels der Methode Get() kopiert werden.

Methode Get()

Nach erfolgreichem Aufruf des Funktionsbausteins ist der Lesevorgang beendet und die gelesenen Adapterinformationen können mittels der Methode Get() kopiert werden.

Es ist möglich die Informationen aller Adapter gemeinsam zu kopieren. Ebenso können die Informationen pro Adapter einzeln nacheinander kopiert werden.

Beim Aufruf wird ein lokales Array (Typ: ST_IpAdapterInfo) angegeben. Jedes Array-Element liefert so Informationen eines Adapters.

METHOD Get : BOOL
VAR_INPUT
    pAdapters        : POINTER TO ST_IpAdapterInfo; // pointer to array of adapter info (variable array length)
    nAdaptersSize    : UDINT; // size in bytes of array of adapter info
END_VAR

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS-Bibliotheken (Kategoriegruppe)

TwinCAT v3.1.4024

PC oder CX (x86, x64, Arm®)

Tc2_Utilities (System) >= 3.3.48.0