PeekFromSpecificClient 方法

概述

类型:

方法

适用的版本:

V1.0.4.0

G-SE-0045941.2.gif-high.gif

 

 

任务

读取源 IP 和端口指定的客户端的接收缓冲区中存储的数据。

功能描述

读取源 IP 和端口指定的客户端的接收缓冲区中存储的数据,读取后不移除数据。

当数据需要达到一定的数量才能被正确处理并且可根据部分数据(例如长度字段)确定该数量时可以使用 Peek 方法。在这种情况下,只需调用一次 Receive 方法就可以将数据复制到应用中。

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

要读取的字节数。

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

使用对象

oFB_TCPServer/FB_TCPServer2