Accept 方法

概述

类型:

方法

适用的版本:

V1.0.4.0

任务

接受传入连接,以便进行数据传输。

功能描述

接受传入连接,以便进行数据传输。连接的源 IP 地址和源端口作为输出。

如果功能被成功执行,则 BOOL 返回值为 TRUE。如果返回值为 FALSE,则评估属性 Result

服务器的状态切换

阶段

描述

1

初始状态:IdleNewConnectionAvailable 为 TRUE

2

功能调用

3

状态:Accepting

4

最终状态:Listening,否则便说明检测到错误

积压管理

TCP 栈可即时接受入站连接,但这些连接会被积压。对于客户端而言,这只是普通连接,能够向服务器发送数据。因此,即便是已被客户端关闭的连接,也会被接受。从此客户端接收的数据仍然可用,只要未使用其中一种接收方法来读出数据,连接就依然注册在属性 ConnectedClients 内。使用 Receive 方法读出这种客户端连接的数据时,此客户端连接便会从属性为 ConnectedClients 的列表中消失。

可利用参数 Gc_uiTCPServerMaxBacklog 在此库的 GPL 中设置积压的连接数(请参阅全局变量)。

接口

输出

数据类型

有效范围

描述

q_sClientIP

STRING(15)

-

被接受的客户端的 IP 编码成字符串值。

q_dwClientIP

DWORD

-

DWORD 格式的客户端 IP 地址;每个字节表示 IPv4 地址的一个数位。

q_uiClientPort

UINT

1 ...65535

客户端的源端口。

使用对象

  • FB_TCPServer/FB_TCPServer2