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.
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
hServer: Die Server-Handle-Variable deren interne Parameter initialisiert werden sollen.
sSrvNetID: String mit der Ams-Netzwerkadresse des TwinCAT TCP/IP Connection Servers. Für den lokalen Rechner (default) kann auch ein Leerstring angegeben werden.
sLocalHost:Die Local-Server IP-Adresse (Ipv4) als String (z.B.: '172.13.15.2'). Für einen Server auf dem lokalen Rechner (default) kann auch ein Leerstring angegeben werden.
nLocalPort:Der Local-Server IP-Port (z.B.: 200).
nMode: Parameter-Flags (Modi). Die zulässigen Parameter sind in der Tabelle aufgeführt und können mit einer ODER Verknüpfung kombiniert werden:
Flag | Beschreibung |
|---|---|
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 TwinCAT System Manager und aktivieren Sie die Loggeransicht. |
bEnable: Dieser Eingang legt das Verhalten des Listener-Sockets fest. Ein vorher geöffneter Listener-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.
Rückgabeparameter | Bedeutung |
|---|---|
TRUE | Kein Fehler |
FALSE | Falscher/unzulässiger Parameterwert |
Beispiel:
Siehe in der Beschreibung von FB_ServerClientConnection.
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
|---|---|---|
TwinCAT v2.9.0 Build >= 1030 | PC or CX (x86) | TcSocketHelper.Lib ( Standard.Lib; TcBase.Lib; TcSystem.Lib; TcUtilities.Lib; TcpIp.Lib werden automatisch eingebunden |
TwinCAT v2.10.0 Build >= 1301 | CX (ARM) |