System.Win.ScktComp.TCustomWinSocket.ReceiveBuf
Delphi
function ReceiveBuf(var Buf; Count: Integer): Integer;
C++
int __fastcall ReceiveBuf(void *Buf, int Count);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Win.ScktComp.pas System.Win.ScktComp.hpp |
System.Win.ScktComp | TCustomWinSocket |
Description
Lit jusqu'à Count octets de la connexion de socket dans le paramètre Buf.
Appelez la méthode ReceiveBuf pour lire via la connexion de socket dans le gestionnaire d'événement OnSocketEvent d'un objet socket Windows ou dans les gestionnaires d'événements OnRead et OnClientRead d'un composant socket. ReceiveBuf renvoie le nombre d'octets effectivement lus. Si aucun octet n'a été lu, ReceiveBuf renvoie –1.
ReceiveBuf ne fonctionne qu'en réponse à une notification de lecture adressée à un socket Windows non-bloquant. Les sockets bloquants doivent utiliser un objet TWinSocketStream pour la lecture. L'objet TWinSocketStream attend que le socket distant soit prêt avant de transférer des informations.
Remarque : Même si la méthode ReceiveLength peut renvoyer la taille estimée du tampon nécessaire pour récupérer des informations du socket, le nombre d'octets qu'elle renvoie n'est pas nécessairement exact.