System.Win.ScktComp.TCustomWinSocket.ReceiveBuf

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ReceiveBuf(var Buf; Count: Integer): Integer;

C++

int __fastcall ReceiveBuf(void *Buf, int Count);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Win.ScktComp.pas
System.Win.ScktComp.hpp
System.Win.ScktComp TCustomWinSocket

Beschreibung

Liest bis zu Count Bytes aus der Socket-Verbindung in den Parameter Buf.

Verwenden Sie ReceiveBuf zum Lesen aus der Socket-Verbindung in der Ereignisbehandlungsroutine für OnSocketEvent eines Windows-Socket-Objekts oder in der Ereignisbehandlungsroutine für OnRead bzw. OnClientRead einer Socket-Komponente. ReceiveBuf gibt die Anzahl der tatsächlich gelesenen Bytes zurück. Wenn keine Bytes gelesen wurden, liefert ReceiveBuf -1.

ReceiveBuf kann nur zur Beantwortung von Lesebenachrichtigungen für nichtblockierende Sockets aufgerufen werden. Blockierende Sockets müssen zum Lesen ein TWinSocketStream-Objekt verwenden. Dieses wartet, bis der Remote-Socket zur Datenübertragung bereit ist.

Anmerkung:  Die Anzahl der Bytes, die aus der Verbindung gelesen werden sollen, wird mit der Methode ReceiveLength festgelegt.

Siehe auch