ReceiveNetworkData()

Syntax

Ergebnis = ReceiveNetworkData(Verbindung, *DatenPuffer, DatenPufferLänge)
Beschreibung
Empfängt Roh-Daten vom angegebenen Client. Diese Funktion kann sowohl von Client- als auch Server-Applikationen genutzt werden und sollte nur aufgerufen werden, nachdem ein #PB_NetworkEvent_Data Ereignis empfangen wurde.

Parameter

Verbindung Die Verbindung, von der Daten empfangen werden sollen. Auf der Server-Seite ist 'Verbindung' der Client, welcher die Daten gesendet hat (kann einfach mittels EventClient() ermittelt werden). Auf der Client-Seite wird 'Verbindung' von OpenNetworkConnection() zurückgegeben.
*DatenPuffer Die Speicheradresse, wohin die empfangenen Daten gespeichert werden sollen. Ein Speicherbereich kann mittels AllocateMemory() erstellt werden.
DatenPufferLänge Die Länge des Puffers, 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 weitere 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

NetworkClientEvent(), NetworkServerEvent(), SendNetworkData()

Unterstützte OS

Alle

<- OpenNetworkConnection() - Network Inhaltsverzeichnis - SendNetworkData() ->