Método ReceiveFromSpecificClient

Descripción general

Tipo:

Método

Disponible desde:

V1.0.4.0

Tarea

Lee los datos almacenados en el búfer de recepción del cliente especificado mediante su IP y puerto de origen y los elimina si se han leído sin detectar ningún error.

Descripción funcional

Lee los datos almacenados en el búfer de recepción del cliente especificado mediante su IP y puerto de origen y los elimina si se han leído sin detectar ningún error.

El valor de retorno de UDINT indica el número de bytes que se escribirá en el búfer incluido en la aplicación.

Para obtener información adicional sobre los métodos de recepción, consulte la sección Método de recepción.

Consideraciones sobre las conexiones que utilizan TLS

El comportamiento de los métodos Peek y Receive puede ser diferente para las conexiones con TLS y sin TLS. en especial cuando se intercambian paquetes de datos de gran tamaño. Al ejecutar los métodos en una conexión con TLS, es posible que sea necesario ejecutar diversas llamadas de método hasta que todos los datos se hayan copiado o movido al búfer de la aplicación. En cualquier caso, antes de procesar los datos, compruebe la cantidad de datos que se han copiado o movido y si los datos están completos.

Interfaz

Entrada

Tipo de datos

Rango válido

Descripción

i_sClientIP

STRING(15)

-

Dirección IP del cliente conectado desde donde se van a leer los datos.

i_uiClientPort

UINT

De 1 a 65535

Puerto de origen del cliente conectado desde donde se van a leer los datos.

i_pbyReceiveBuffer

POINTER TO BYTE

-

Dirección de inicio del búfer en el que se van a escribir los datos recibidos.

i_udiReceiveBufferSize

UDINT

De 1 a 2147483647

Número de bytes que deben leerse.

NOTA: El valor no deberá superar el tamaño del búfer.
NOTA: Para evitar una infracción de acceso provocada por un acceso no válido del puntero (fuera de los límites) a la memoria, utilice el operador aritmético SIZEOF junto con el búfer de destino para determinar el valor de i_udiReceiveBufferSize.

In_Out

Tipo de datos

Rango válido

Descripción

iq_udiFillLevel

UDINT

De 1 a 2147483647

Indica el nivel de llenado del búfer.

Antes de la llamada de función:

Los datos se escribirán a partir de este desplazamiento.

Tras la llamada de función:

Se actualiza sumando el número de bytes escritos al valor original.

Utilizado por

  • FB_TCPServer/FB_TCPServer2