PR_NewTCPSocket

创建一个新的 IPv4 TCP 套接字。

语法

#include <prio.h>

PRFileDesc* PR_NewTCPSocket(void);

返回值

该函数返回以下值之一

• 成功完成时，返回指向为新打开的 IPv4 TCP 套接字创建的 PRFileDesc 对象的指针。

• 如果创建新的 TCP 套接字失败，则返回 NULL。

描述

TCP（传输控制协议）是 TCP/IP 协议套件中面向连接的可靠字节流协议。 PR_NewTCPSocket 创建一个新的 IPv4 TCP 套接字。TCP 连接由一个被动套接字（服务器）接受来自一个主动套接字（客户端）的连接建立请求来建立。通常，服务器使用 PR_Bind 将其套接字绑定到一个众所周知的端口，调用 PR_Listen 开始监听连接建立请求，并调用 PR_Accept 接受连接。客户端使用 PR_Connect 发出连接请求。

建立连接后，客户端和服务器可以在彼此之间发送和接收数据。要接收数据，可以调用 PR_Read 或 PR_Recv。要发送数据，可以调用 PR_Write、PR_Writev、PR_Send 或 PR_TransmitFile。 PR_AcceptRead 适用于服务器接受新客户端连接并在一个函数调用中读取客户端的第一个请求。

TCP 连接可以通过 PR_Shutdown 关闭，套接字应通过 PR_Close 关闭。

另请参阅

PR_NewTCPSocket 已弃用，因为它被硬编码为创建 IPv4 TCP 套接字。新代码应改用 PR_OpenTCPSocket，它允许指定新 TCP 套接字的地址族（IPv4 或 IPv6）。