接受传入连接,以便进行数据传输。
接受传入连接,以便进行数据传输。连接的源 IP 地址和源端口作为输出。
如果功能被成功执行,则 BOOL 返回值为 TRUE。如果返回值为 FALSE,则评估属性 Result。
阶段 |
描述 |
---|---|
1 |
初始状态:Idle,NewConnectionAvailable 为 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 |
客户端的源端口。 |
oFB_TCPServer/FB_TCPServer2