System.Win.ScktComp.TCustomWinSocket.ReceiveBuf
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.