ReceiveNetworkData()

Syntax

Ergebnis = ReceiveNetworkData(Verbindung, *DatenPuffer, DatenPufferLänge)

Empfängt die Roh-Daten vom angegebenen Client. Diese Funktion kann sowohl von Client- als auch Server-Applikationen genutzt werden.

Parameter

Verbindung	Gibt die Verbindung an, von der Daten empfangen werden sollen. Auf der Server-Seite ist 'Verbindung' der Client, welcher die Daten gesendet hat (die ClientID kann einfach mittels EventClient() ermittelt werden). Auf der Client-Seite wird 'Verbindung' von OpenNetworkConnection() zurückgegeben.
*DatenPuffer	Gibt die Speicheradresse an, wohin die empfangenen Daten gespeichert werden sollen. Ein Speicherbereich kann mittels AllocateMemory() erstellt werden.
DatenPufferLänge	Gibt die Länge des Puffers an, in den die empfangenen Daten gespeichert werden sollen.

Rückgabewert

Gibt die Anzahl an empfangenen Bytes zurück. Ist das 'Ergebnis' gleich der 'DatenPufferLänge', dann sind noch mehr Daten zum Einlesen verfügbar. Wenn ein Fehler bei der Verbindung auftrat (Verbindung unterbrochen, Verbindung durch den Server beendet, etc.), wird 'Ergebnis' gleich -1 sein.

Anmerkungen

Bei UDP-Verbindungen beträgt die maximale 'DatenPufferLänge' 2048. Bei TCP-Verbindungen beträgt die maximale 'DatenPufferLänge' 65536.

Siehe auch

ReceiveNetworkFile(), NetworkClientEvent(), NetworkServerEvent(), SendNetworkData()

Unterstützte OS

Alle