Lire les données enregistrées dans le tampon de réception, sans les supprimer
Lit les données enregistrées dans le tampon de réception, sans les supprimer du tampon après leur lecture.
La méthode Peek peut être utilisée si le traitement correct requiert la disponibilité d'une certaine quantité de données et si cette quantité peut être déterminée d'après une partie des données (un champ de longueur, par exemple). Dans ce cas, les données peuvent être copiées dans l'application par un appel de la méthode Receive.
La valeur de retour UDINT indique le nombre d’octets écrits dans la mémoire tampon fournie par l’application.
Considérations pour les connexions en utilisant TLS
Le fonctionnement des méthodes Peek et Receive peut être différent pour les différentes connexions avec et sans la sécurité TLS. En particulier si des paquets volumineux sont échangés. Lors de l'exécution des méthodes sur une connexion qui utilise TLS, il peut être nécessaire d'exécuter des appels de méthode jusqu'à la copie ou le déplacement de toutes les données déplacées sur la mémoire tampon de l'application. Dans tous les cas, vérifiez avant le traitement des données, la quantité de données copiées ou déplacées et si les données sont complètes.
|
Entrée |
Type de données |
Plage valide |
Description |
|---|---|---|---|
|
i_pbyReceiveBuffer |
POINTER TO BYTE |
- |
Adresse de départ du tampon à partir de laquelle les données reçues doivent être écrites. |
|
i_udiReceiveBufferSize |
UDINT |
1…2 147 483 647 |
Nombre d’octets à lire. NOTE : La valeur ne doit pas dépasser la taille de la mémoire tampon. |
NOTE : Pour empêcher tout accès non autorisé, par exemple un accès de pointeur (hors limites) dans la mémoire, utilisez l'opérateur arithmétique SIZEOF avec le tampon cible pour déterminer la valeur de i_udiReceiveBufferSize.
oFB_TCPClient/FB_TCPClient2
