F_CreateServerHnd

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

Rückgabewert

Name	Typ	Beschreibung
F_CreateServerHnd	BOOL	Liefert TRUE, wenn alles okay ist, FALSE, wenn ein falscher Parameterwert vorliegt.

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.

/ 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)

Sehen Sie dazu auch

T_HSERVER