F_CreateServerHnd

F_CreateServerHnd 1:

Mit der Funktion F_CreateServerHnd werden die internen Parameter einer Server-Handle-Variablen hServer initialisiert/gesetzt. Das Server-Handle wird dann an die Instanzen des FB_ServerClientConnection-Funktionsbausteins per VAR_IN_OUT übergeben. Mit einer Instanz des FB_ServerClientConnection-Funktionsbausteins kann eine Verbindung des Servers auf einfache Weise verwaltet werden (auf- und abgebaut werden). Soll ein Server mehrere Verbindungen gleichzeitig aufbauen können, dann wird das gleiche Server-Handle an mehrere Instanzen des FB_ServerClientConnection-Funktionsbausteins übergeben.

Syntax

FUNCTION F_CreateServerHnd : BOOL
VAR_IN_OUT
    hServer         : T_HSERVER; 
END_VAR
VAR_INPUT
    sSrvNetID       : T_AmsNetID := ''; 
    sLocalHost      : STRING(15) := ''; 
    nLocalPort      : UDINT := 0;
    nMode           : DWORD := LISTEN_MODE_CLOSEALL (* OR CONNECT_MODE_ENABLEDBG*);
 bEnable            : BOOL := TRUE;
END_VAR

F_CreateServerHnd 2: Rückgabewert

Name

Typ

Beschreibung

F_CreateServerHnd

BOOL

Liefert TRUE, wenn alles okay ist, FALSE, wenn ein falscher Parameterwert vorliegt.

F_CreateServerHnd 3: Eingänge

Name

Typ

Beschreibung

sSrvNetID

T_AmsNetID

String mit der AMS-Netzwerkadresse des TwinCAT TCP/IP Connection Servers. Für den loka-len Rechner (default) kann auch ein Leerstring angegeben werden.

sLocalHost

T_IPv4Addr

Local-Server IP-Adresse (Ipv4) als String (z.B. '172.13.15.2'). Für einen Server auf dem loka-len Rechner (default) kann auch ein Leerstring angegeben werden.

nLocalPort

UDINT

Local-Server IP-Port (z.B. 200).

nMode

DWORD

Parameter-Flags (Modi). Die zulässigen Parameter sind hier aufgeführt und können mit einer ODER-Verknüpfung kombiniert werden.

LISTEN_MODE_CLOSEALL:

Alle vorher geöffneten Socket-Verbindungen werden zuerst geschlossen (default).

CONNECT_MODE_ENABLEDBG:

Aktiviert das Loggen von Debug-Meldungen im Application-Log. Um die Debug-Meldungen zu sehen öffnen Sie den Twin-CAT System Manager und aktivieren Sie die Loggeransicht.

bEnable

BOOL

Dieser Eingang legt das Verhalten des Listener-Sockets fest. Ein vorher geöffneter Liste-ner Socket bleibt geöffnet, solange dieser Eingang TRUE ist. Wenn dieser Eingang FALSE ist, dann wird der Listener-Socket automatisch geschlossen aber erst dann, nach dem die letzte (vorher) akzeptierte Verbindung auch geschlossen wurde.

F_CreateServerHnd 4:/F_CreateServerHnd 5: Ein-/Ausgänge

Name

Typ

Beschreibung

hServer

T_HSERVER

Server-Handle-Variable, deren interne Parameter initialisiert werden sollen.

Beispiel:

Siehe FB_ServerClientConnection.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken (Kategoriegruppe)

TwinCAT v3.1.0

PC oder CX (x86, x64, Arm®)

Tc2_TcpIp (Communication)