Méthode PeekFromSpecificClient
Tâche
Lire les données enregistrées dans le tampon de réception du client identifié par une adresse IP et un port source
Description fonctionnelle
Lit les données enregistrées dans le tampon de réception du client identifié par l'adresse IP et le port source, 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 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.
Interface
|
Entrée |
Type de données |
Plage valide |
Description |
|---|---|---|---|
|
i_sClientIP |
STRING(15) |
- |
Adresse IP du client connecté à partir duquel les données doivent être lues. |
|
i_uiClientPort |
UINT |
1…65 535 |
Port source du client connecté à partir duquel les données doivent être lues. |
|
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.
|