Eigenschaften von FB_TCPServer/FB_TCPServer2

Allgemeine Informationen

Die vom FB_TCPServer2 bereitgestellten Eigenschaften haben nahezu dieselbe Funktion wie die entsprechenden vom Funktionsbaustein FB_TCPServer bereitgestellten Eigenschaften. Die Unterschiede sind unte in der ensprechenden Tabelle beschrieben.

Allgemeine Eigenschaften von FB_TCPServer und FB_TCPServer2

Name

Datentyp

Zugriff

Beschreibung

IsDataAvailable

BOOL

Lesen

Gibt an, ob von mindestens 1 Client Daten zum Lesen verfügbar sind.

IsNewConnectionAvailable

BOOL

Lesen

Gibt an, ob eine neue eingehende Verbindung auf Annahme wartet.

NumberOfConnectedClients

UINT

Lesen

Gibt die Anzahl an verbundenen Clients (einschl. getrennter Clients, deren Daten gelesen werden müssen) zurück. (Bereich: 0 bis GPL.Gc_uiTCPServerMaxConnections)

Result

ET_Result

Lesen

Verweist auf das Ergebnis des letzten Methodenaufrufs.

Wenn sich das Ergebnis von Ok unterscheidet, wird der Wert nicht überschrieben, auch nicht bei Aufruf einer Methode.

State

ET_State

Lesen

Gibt den Zustand des Sockets an.

TotalBytesReceived

ULINT

Lesen

Zählt die Gesamtanzahl empfangener Bytes. (Bereich: 1 bis 264-1)

TotalBytesSent

ULINT

Lesen

Zählt die Gesamtanzahl gesendeter Bytes. (Bereich: 1 bis 264-1)

SockOpt_CustomPort

UDINT

Lesen/Schreiben

Ermöglicht die Aktivierung/Deaktivierung der Socket-Option SO_LINGER für die vom FB_TcpServer eingerichtete Verbindung.

SockOpt_KeepAlive

BOOL

Lesen/Schreiben

Wenn TRUE, weist den TCP-Stapel an, regelmäßig leere Pakete zu senden, um zu prüfen, ob der dezentrale Standort erreichbar ist. Ist dies nicht mehr der Fall, dann wird der Verbindungsstatus zu Shutdown geändert.

HINWEIS: In den meisten Fällen sollte diese Option gesetzt werden, damit eine Trennung des dezentralen Standorts (ausgeschaltet oder Stecker gelöst) erkannt werden kann.

HINWEIS: Wenn die Socket-Option KeepAlive für den Server deaktiviert ist, kann sie für die verbundenen Clients nicht aktiviert werden.

SockOpt_ReuseAddress

BOOL

Lesen/Schreiben

Wenn TRUE, kann ein Server geöffnet werden, auch wenn der Port noch an eine andere Ressource gebunden ist, aber nicht aktiv von dieser verwendet wird.

SockOpt_ReceiveBufferSize

UDINT

Lesen/Schreiben

Wird zum Setzen oder Abrufen der Größe des Stapel-Empfangspuffers verwendet. Um Datenverluste zu vermeiden, sollte er immer größer sein als die zu einem Zeitpunkt empfangene Datenmenge. (Bereich: 1 bis 2147483647)

SockOpt_SendBufferSize

UDINT

Lesen/Schreiben

Wird zum Setzen oder Abrufen der Größe des Stapel-Sendepuffers verwendet. Er sollte immer größer sein als die zu einem Zeitpunkt gesendete Datenmenge.

(Bereich: 1 bis 2147483647)

Weitere Eigenschaften von FB_TCPServer

Name

Datentyp

Zugriff

Beschreibung

BytesAvailableToReadFirstAvailableClient

UDINT

Lesen

Gibt die Anzahl an Bytes an, die vom ersten Client mit verfügbaren Daten zum Lesen zur Verfügung stehen. (Bereich: 0 bis 2147483647)

BytesAvailableToReadTotal

UDINT

Lesen

Gibt die Gesamtanzahl an Bytes an (Summe), die von den verbundenen Clients zum Lesen zur Verfügung stehen. (Bereich: 0 bis 2147483647)

ConnectedClients

ARRAY [1 bis GPL. Gc_uiTCPServerMaxConnections] OF ST_ClientConnection

Lesen

Gibt einen Array mit Informationen zu den verbundenen Clients zurück. Siehe ST_ClientConnection.

Weitere Eigenschaften von FB_TCPServer2

Name

Datentyp

Zugriff

Beschreibung

ConnectedClients2

ARRAY [1 bis GPL. Gc_uiTCPServerMaxConnections] OF ST_ClientConnection2

Lesen

Gibt einen Array mit Informationen zu den verbundenen Clients zurück. Siehe ST_ClientConnection2.

TimeoutAcceptTls

UDINT

Lesen/Schreiben

Gibt den Timeout in Sekunden für das Annehmen einer eingehenden Verbindung mit der Methode Accept auf Ports an, die mit der Methode OpenTls geöffnet wurden.

TlsUsed

BOOL

Lesen

Gibt an, ob der Port mit der Methode OpenTls geöffnet wurde.