ReceiveFromSpecificClient 方法

概述

类型:

方法

适用的版本:

V1.0.4.0

G-SE-0045939.2.gif-high.gif

 

 

任务

读取源 IP 和端口指定的客户端的接收缓冲区中存储的数据,如果读取完数据后没有检测到错误,并移除数据。

功能描述

读取源 IP 和端口指定的客户端的接收缓冲区中存储的数据,如果读取完数据后没有检测到错误,并移除数据。

UDINT 返回值指示写入到应用程序提供的缓冲区中的字节数。

有关接收方法的其他信息,请参阅接收方法

使用 TLS 建立连接时的注意事项

对于使用 TLS 和不使用 TLS 建立的不同连接,方法 Peek 和 Receive 的行为可能不同。这尤其体现在交换大数据包时。在藉由使用 TLS 的连接执行方法时,可能必须执行多次方法调用,直到所有数据都被复制或移动到应用程序缓冲区。在任何情况下,在处理数据之前,都应确认复制或移动的数据量以及数据是否完整。

接口

输入

数据类型

有效范围

描述

i_sClientIP

STRING(15)

-

将从中读取数据的已连接客户端的 IP 地址。

i_uiClientPort

UINT

1 ... 65535

将从中读取数据的已连接客户端的源端口。

i_pbyReceiveBuffer

POINTER TO BYTE

-

接收到的数据所写入的缓冲区的起始地址。

i_udiReceiveBufferSize

UDINT

1 ... 2147483647

要读取的字节数。

注意: 这个值不得大于缓冲区的大小。

注意: 为了防止因存储器指针访问无效(在范围外)引起的非法访问,利用算术运算符 SIZEOF 和目标缓冲区来确定 i_udiReceiveBufferSize 的值。

In_Out

数据类型

有效范围

描述

iq_udiFillLevel

UDINT

1 ... 2147483647

指示缓冲区的填充水平。

功能调用前:

将从这个偏移开始写入数据。

功能调用后:

通过将写入的字节数添加到原始值来更新。

使用对象

oFB_TCPServer/FB_TCPServer2