Methode PeekFromSpecificClient

Überblick

Typ

Methode

Verfügbar ab

V1.0.4.0

G-SE-0045941.2.gif-high.gif

 

 

Aufgabe

Lesen der gespeicherten Daten im Empfangspuffer des Clients, dessen Ausgangs-IP-Adresse und -Port angegeben sind.

Funktionsbeschreibung

Liest die gespeicherten Daten im Empfangspuffer des Clients, dessen Ausgangs-IP-Adresse und -Port angegeben sind, ohne diese anschließend daraus zu entfernen.

Die Peek-Methode kann eingesetzt werden, wenn eine bestimmte Datenmenge verfügbar sein muss, um eine ordnungsgemäße Verarbeitung zu gewährleisten, und diese Menge anhand von Datenteilen (z. B. einem Länge-Feld) bestimmt werden kann. In diesem Fall können die Daten durch einen Aufruf der Methode Receive in die Anwendung kopiert werden.

Der UDINT-Rückgabewert verweist auf die Anzahl der in den von der Anwendung bereitgestellten Puffer geschriebenen Bytes.

Hinweise für Verbindungen mit TLS

Das Verhalten der Methoden Peek und Receive ist möglicherweise bei Verbindungen mit oder ohne TLS unterschiedlich. Diese gilt insbesondere, wenn große Datenpakete ausgetauscht werden. Bei der Ausführung der Methoden in einer Verbindung mit TLS ist kann es notwendig sein, dass mehrere Methodenaufrufe ausgeführt werden müssen, bis alle Daten in den Anwendungs­puffer kopiert oder verschoben wurden. Überprüfen Sie in jedem Fall vor der Verarbeitung der Daten, welche Menge Daten kopiert oder verschoben wurde und ob die Daten vollständig sind.

Schnittstelle

Eingang

Datentyp

Gültiger Bereich

Beschreibung

i_sClientIP

STRING(15)

-

IP-Adresse des verbundenen Clients, dessen Daten gelesen werden sollen.

i_uiClientPort

UINT

1 ... 65535

Ausgangs-Port des verbundenen Clients, dessen Daten gelesen werden sollen.

i_pbyReceiveBuffer

POINTER TO BYTE

-

Startadresse des Puffers, in den die empfangenen Daten geschrieben werden.

i_udiReceiveBufferSize

UDINT

1 ... 2147483647

Anzahl der zu lesenden Bytes.

HINWEIS: Der Wert darf die Größe des Puffers nicht überschreiten.

Verwendet von

oFB_TCPServer/FB_TCPServer2