FB_GetAdaptersInfoEx

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.

VAR_INPUT

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

sNetID: Hier kann die Netzwerkadresse des TwinCAT-Rechners angegeben werden, dessen Adapterinformationen gelesen werden sollen. Für den lokalen PC kann auch ein Leerstring angegeben werden (Typ: T_AmsNetID).

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

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

VAR_OUTPUT

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

nAdapters: 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

Sehen Sie dazu auch

ST_IPAdapterInfo