Windows Socket编程

Windows Socket基于Unix Socket,提供TCP和UDP两种通信协议。TCP是面向连接、可靠的传输协议,适用于安全要求高的场景;UDP则是面向无连接、不可靠的协议,适合大量数据传输。关键类型包括SOCKET、sockaddr_in和in_addr。在Windows环境下使用Socket API前,需加载动态库,并处理字节序问题。主要API有socket、bind、listen、accept、connect、send、recv和close。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Windows Socket是以Unix Socket为基础发展而来,所以很多函数与Unix/Linux下的API相同。

套接字是一条连接的两端,每个端点由IP和端口号组成,IP标示了网络中的主机,端口号标示了IP对应的主机的某个进程,因此一个链接表示的是一个进程与一个进程间的通信。所以Socket通信时进程间通信的一种方式。

TCP & UDP

TCP,Transmission Control Protocol,传输控制协议,面向连接、可靠的传输层协议,用于数据量小但安全性高的场合。
UDP,User Datagram Protocol,用户数据报协议,面向无连接、不可靠的传输层协议,用户数据量大但误差要求不高的场合。

面向连接的套接字通信时序图如下:
TCP时序图
Windows环境下,调用socket API需要包含windows socket动态库

#include <winsock2.h> //<winsock.h>
#pragma  comment(lib,"WS2_32.lib")

并且在调用socket API之前得首先调用WSAStartup()以加载动态库。

/* 
 * wVersionRequested:动态库的版本,可使用MAKEWORD宏组成
 * lpwsadata:返回加载的动态库的基本信息,如加载是否成功,实际版本等。
 */
int WSAStartup(WORD wVersionRequested,LPWSADATA lpwsadata);

关键类型及结构体

1. SOCKET

SOCKET被定义为一个套接字的标识符,实际上就是一个无符整形数,用以表示不同的连接。

2. sockaddr_in

struct sockaddr_in结构体用于描述一个端口的地址信息。定义如下:

/*
 * sin_family:使用的协议簇,AF_INET表示IP协议
 * sin_port:端口号,用户指定,需转换为网络字序
 * sin_addr:IP地址,结构体用以表示四字节IP地址
 * sin_zero:零字节填充,用以兼容struct sockaddr
 */
struct sockaddr_in
{
     short sin_family;
     u_short sin_port;
      struct in_addr sin_addr;
     char sin_zero[8];
};

3. in_addr

/*
 * S_un_b:用四个unsigned char表示IP地址
 * S_un_w:用两个unsigned short 表示IP地址
 * S_addr:用一个usnigned long表示IP地址
 */
struct in_addr
{
    union 
    {
        struct
        { 
            UCHAR s_b1,s_b2,s_b3,s_b4; 
        }S_un_b;
        struct
        { 
            USHORT s_w1,s_w2; 
        }S_un_w;
        ULONG S_addr;
   } S_un;
}

字节序问题

数据存储存在大小端问题,且不同CPU存储数据格式不同,而数据传输也存在大小端问题,对于一个四字节的数据0x12345678,大小端内存对应如下:

内存地址0x00010x00020x00030x0004
大端12345678
小端78563412

可以看出:big-endian最直观,little-endian最符合人的思维。
为了保证网络传输的统一性,TCP/IP协议规定网络数据传输一律采用Big-endian格式,与CPU和操作系统无关。为了实现CPU字节序到网络字节序的转换,BSD socket提供了以下函数:

/* host to net(short),本机字节序到网络字节序转换(short) */
uint16_t htons(uint16_t hostshort); 

/* host to net(long),本机字节序到网络字节序转换(long) */
uint32_t htonl(uint32_t hostlong);

/* net to host(short),网络字节序到本机字节序转换(short) */
uint16_t ntohs(uint16_t netshort);

/* net to host(long), 网络字节序到本机字节序转换(long)*/
uint32_t ntohl(uint32_t netlong);

API

socket()

/* 
 * 创建套接字(server,client)
 * @af:使用的协议地址家族,TCP/UDP使用AF_INET
 * @type:套接字类型,SOCK_STREAM,SOCK_DGRAM,SOCK_RAW
 * @protocol:使用的协议,SOCK_STREAM-IPPROTO_TCP,SOCK_DGRAM-IPPROTO_UDP
 * @返回值:当创建成功时返回套接字句柄,失败时返回INVALID_SOCKET
 */
SOCKET socket(int af, int type, int protocol);

bind()

/* 
 * 绑定套接字(server)
 * @s:socket创建的套接字
 * @name:待绑定的地址,该地址是指服务器的多张网卡的其中一个地址,可使用INADDR_ANY不指定而由系统分配
 * @namelen:待绑定地址的长度
 * @返回值:成功返回0,可使用GetLastError()获取错误代码
 */ 
int bind(SOCKET s, const struct sockaddr*name, int namlen);

listen()

/*
 * 监听套接字(server)
 * @s:socket创建的监听套接字
 * @backlog:等待连接的最大队列长度
 * @返回值:成功返回0,可使用GetLastError()获取错误代码
 */ 
int listen (SOCKET s,int backlog);

accept()

/*
 * 接收套接字(server) 
 * @s:监听套接字
 * @addr:用于接收客户端地址
 * @addlen:用于接收客户端地址长度
 * @返回值:成功客户端套接字句柄,服务器可使用该套接字与客户端通信,而监听套接字继续监听,可使用GetLastError()获取错误代码
 */
SOCKET accept(SOCKET s, struct sockaddr*addr, int *addrlen);

connect()

/*
 * 连接套接字(client)
 * @s:客户端套接字
 * @name:服务器地址结构体指针
 * @namelen:服务器地址结构体长度
 * @返回值:成功返回0,可使用GetLastError()获取错误代码
 */
int connect(SOCKET s, const struct sockaddr*name, int namelen);

send()

/*
 * 发送消息(server,client)
 * @s:对方通信套接字;
 * @buff:待发送消息缓冲区;
 * @len:发送消息的长度;
 * @flags:发送消息标记。
 * @返回值:成功返回实际发送的字节数,否则可使用GetLastError()获取错误代码。
 */
int send(SOCKET s,const char *buff,int len,int flags);

recv()

/*
 * 接收消息(server,client)
 * @s:对方通信套接字;
 * @buf:接收缓冲区;
 * @len:缓冲区长度;
 * @flags:接收消息标记。
 * @返回值:成功返回实际接收的字节数,否则可使用GetLastError()获取错误代码
 */ 
int recv(SOCKET s, char *buf, int len, int flags);

close()

/* 
 * 关闭套接字(server,client)
 * @s:待关闭套接字
 * @返回值:成功返回0,可使用GetLastError()获取错误代码
 */ 
int closesocket( SOCKET s);

错误信息

宏定义错误码描述
WSAEINTR10004Interrupted function call.阻塞操作被函数WSACancelBlockingCall ()调用所中断
WSAEACCES10013Permission denied.试图使用被禁止的访问权限去访问套接字。例如,在没有使用函数setsockopt()的SO_BROADCAST命令设置广播权限的套接字上使用函数sendto()给一个广播地址发送数据
WSAEFAULT10014Bad address.系统检测到调用试图使用的一个指针参数指向的是一个非法指针地址。如果应用程序传递一个非法的指针值,或缓冲区长度太小,此错误发生。例如,参数为结构sockaddr,但参数的长度小于sizeof(struct sockaddr)
WSAEINVAL10022Invalid argument.提供了非法参数(例如,在使用setsockopt()函数时指定了非法的level)。在一些实例中,它也可能与套接字的当前状态相关,例如,在套接字没有使用listen()使其处于监听时调用accept()函数
WSAEMFILE10024Too many open files.打开了太多的套接字。不管是对整个系统还是每一进程或线程,Windows Sockets实现都可能有一个最大可用的套接字句柄数
WSAEWOULDBLOCK10035Resource temporarily unavailable.此错误由在非阻塞套接字上不能立即完成的操作返回,例如,当套接字上没有排队数据可读时调用了recv()函数。此错误不是严重错误,相应操作应该稍后重试。对于在非阻塞SOCK_STREAM套接字上调用connect()函数来说,报告WSAEWOULDBLOCK是正常的,因为建立一个连接必须花费一些时间
WSAEINPROGRESS10036Operation now in progress.一个阻塞操作正在执行。Windows Sockets只允许一个任务(或线程)在同一时间可以有一个未完成的阻塞操作,如果此时调用了任何函数(不管此函数是否引用了该套接字或任何其它套接字),此函数将以错误码WSAEINPROGRESS返回
WSAEALREADY10037Operation already in progress.当在非阻塞套接字上已经有一个操作正在进行时,又有一个操作试图在其上执行则产生此错误。如:在一个正在进行连接的非阻塞套接字上第二次调用connect()函数;或取消一个已经被取消或已完成的异步请求(WSAAsyncGetXbyY())
WSAENOTSOCK10038Socket operation on non-socket.操作试图不是在套接字上进行。它可能是套接字句柄参数没有引用到一个合法套接字,或者是调用select()函数时,一个fd_set中的成员不合法
WSAEDESTADDRREQ10039Destination address required.在套接字上一个操作所必须的地址被遗漏。例如,如果sendto()函数被调用且远程地址为ADDR_ANY时,此错误被返回。
WSAEMSGSIZE10040Message too long.在数据报套接字上发送的一个消息大于内部消息缓冲区或一些其它网络限制,或者是用来接受数据报的缓冲区小于数据报本身
WSAEPROTOTYPE10041Protocol wrong type for socket.在socket()函数调用中指定的协议不支持请求的套接字类型的语义。例如,ARPA Internet UDP协议不能和SOCK_STREAM套接字类型一同指定
WSAENOPROTOOPT10042Bad protocol option.在getsockopt()或setsockopt()调用中,指定了一个未知的、非法的或不支持的选项或层(level)
WSAEPROTONOSUPPORT10043Protocol not supported.请求的协议没有在系统中配置或没有支持它的实现存在。例如,socket()调用请求一个SOCK_DGRAM套接字,但指定的是流协议
WSAESOCKTNOSUPPORT10044Socket type not supported.不支持在此地址族中指定的套接字类型。例如,socket()调用中选择了可选的套接字类型SOCK_RAW,但是实现却根本不支持SOCK_RAW类型的套接字
WSAEOPNOTSUPP10045Operation not supported.对于引用的对象的类型来说,试图进行的操作不支持。通常它发生在套接字不支持此操作的套接字描述符上,例如,试图在数据报套接字上接收连接
WSAEPFNOSUPPORT10046Protocol family not supported.协议簇没有在系统中配置或没有支持它的实现存在。它与WSAEAFNOSUPPORT有些微的不同,但在绝大多数情况下是可互换的,返回这两个错误的所有Windows Sockets函数的说明见WSAEAFNOSUPPORT的描述
WSAEAFNOSUPPORT10047Address family not supported by protocol family.使用的地址与被请求的协议不兼容。所有的套接字在创建时都与一个地址族(如IP协议对应的AF_INET)和一个通用的协议类型(如SOCK_STREAM)联系起来。如果在socket()调用中明确地要求一个不正确的协议,或在调用sendto()等函数时使用了对套接字来说是错误的地址族的地址,该错误返回
WSAEADDRINUSE10048Address already in use.正常情况下每一个套接字地址(协议/IP地址/端口号)只允许使用一次。当应用程序试图使用bind()函数将一个被已存在的或没有完全关闭的或正在关闭的套接字使用了的IP地址/端口号绑扎到一个新套接字上时,该错误发生。对于服务器应用程序来说,如果需要使用bind()函数将多个套接字绑扎到同一个端口上,可以考虑使用setsockopt()函数的SO_REUSEADDR命令。客户应用程序一般不必使用bind()函数–connect()函数总是自动选择没有使用的端口号。当bind()函数操作的是通配地址(包括ADDR_ANY)时,错误WSAEADDRINUSE可能延迟到一个明确的地址被提交时才发生。这可能在后续的函数如connect()、listen()、WSAConnect()或WSAJoinLeaf()调用时发生
WSAEADDRNOTAVAIL10049Cannot assign requested address.被请求的地址在它的环境中是不合法的。通常地在bind()函数试图将一个本地机器不合法的地址绑扎到套接字时产生。它也可能在connect()、sendto()、WSAConnect()、WSAJoinLeaf()或WSASendTo()函数调用时因远程机器的远程地址或端口号非法(如0地址或0端口号)而产生
WSAENETDOWN10050Network is down.套接字操作遇到一个不活动的网络。此错误可能指示网络系统(例如WinSock DLL运行的协议栈)、网络接口或本地网络本身发生了一个严重的失败。
WSAENETUNREACH10051Network is unreachable.试图和一个无法到达的网络进行套接字操作。它常常意味着本地软件不知道到达远程主机的路由。
WSAENETRESET10052Network dropped connection on reset.在操作正在进行时连接因“keep-alive”检测到失败而中断。也可能由setsockopt()函数返回,如果试图使用它在一个已经失败的连接上设置SO_KEEPALIVE
WSAECONNABORTED10053Software caused connection abort.一个已建立的连接被你的主机上的软件终止,可能是因为一次数据传输超时或是协议错误
WSAECONNRESET10054Connection reset by peer.存在的连接被远程主机强制关闭。通常原因为:远程主机上对等方应用程序突然停止运行,或远程主机重新启动,或远程主机在远程方套接字上使用了“强制”关闭(参见setsockopt(SO_LINGER))。另外,在一个或多个操作正在进行时,如果连接因“keep-alive”活动检测到一个失败而中断,也可能导致此错误。此时正在进行的操作以错误码WSAENETRESET失败返回,后续操作将失败返回错误码WSAECONNRESET。
WSAENOBUFS10055No buffer space available.由于系统缺乏足够的缓冲区空间,或因为队列已满,在套接字上的操作无法执行。
WSAEISCONN10056Socket is already connected.连接请求发生在已经连接的套接字上。一些实现对于在已连接SOCK_DGRAM套接字上使用sendto()函数的情况也返回此错误(对于SOCK_STREAM套接字,sendto()函数的to参数被忽略),尽管其它一些实现将此操作视为合法事件。
WSAENOTCONN10057Socket is not connected.因为套接字没有连接,发送或接收数据的请求不被允许,或者是使用sendto()函数在数据报套接字上发送时没有提供地址。任何其它类型的操作也可以返回此错误,例如,使用setsockopt()函数在一个已重置的连接上设置SO_KEEPALIVE。
WSAESHUTDOWN10058Cannot send after socket shutdown.因为套接字在相应方向上已经被先前的shutdown()调用关闭,因此该方向上的发送或接收请求不被允许。通过调用shutdown()函数来请求对套接字的部分关闭,它发送一个信号来停止发送或接收或双向操作。
WSAETIMEDOUT10060Connection timed out.连接请求因被连接方在一个时间周期内不能正确响应而失败,或已经建立的连接因被连接的主机不能响应而失败。
WSAECONNREFUSED10061Connection refused.因为目标主机主动拒绝,连接不能建立。这通常是因为试图连接到一个远程主机上不活动的服务,如没有服务器应用程序处于执行状态。
WSAEHOSTDOWN10064Host is down.套接字操作因为目的主机关闭而失败返回。套接字操作遇到不活动主机。本地主机上的网络活动没有初始化。这些条件由错误码WSAETIMEDOUT指示似乎更合适。
WSAEHOSTUNREACH10065No route to host.试图和一个不可达主机进行套接字操作。参见WSAENETUNREACH。
WSAEPROCLIM10067Too many processes.Windows Sockets实现可能限制同时使用它的应用程序的数量,如果达到此限制,WSAStartup()函数可能因此错误失败。
WSASYSNOTREADY10091Network subsystem is unavailable.此错误由WSAStartup()函数返回,它表示此时Windows Sockets实现因底层用来提供网络服务的系统不可用。用户应该检查:(1)是否有合适的Windows Sockets DLL文件在当前路径中;(2)是否同时使用了多个WinSock实现。如果有多于一个的WINSOCK DLL在系统中,必须确保搜索路径中第一个WINSOCK DLL文件是当前加载的网络子系统所需要的。查看WinSock实现的文档以确保所有必须的部件都正确地安装并配置好了。
WSAVERNOTSUPPORTED10092WINSOCK.DLL version out of range.当前的WinSock实现不支持应用程序指定的Windows Sockets规范版本。检查是否有旧的Windows Sockets DLL文件正在被访问。
WSANOTINITIALISED10093Successful WSAStartup() not yet performed.应用程序没有调用WSAStartup()函数,或函数WSAStartup()调用失败了。应用程序可能访问了不属于当前活动任务的套接字(例如试图在任务间共享套接字),或调用了过多的WSACleanup()函数。
WSAEDISCON10101Graceful shutdown in progress.由WSARecv()和WSARecvFrom()函数返回,指示远程方已经初始化了一个“雅致”的关闭序列。
WSATYPE_NOT_FOUND10109Class type not found.指定的类没有找到。
WSAHOST_NOT_FOUND11001Host not found.主机未知。此名字不是一个正式主机名,也不是一个别名,它不能在查询的数据库中找到。此错误也可能在协议和服务查询中返回,它意味着指定的名字不能在相关数据库中找到。
WSATRY_AGAIN11002Non-authoritative host not found.此错误通常是在主机名解析时的临时错误,它意味着本地服务器没有从授权服务器接收到一个响应。稍后的重试可能会获得成功。
WSANO_RECOVERY11003This is a non-recoverable error.此错误码指示在数据库查找时发生了某种不可恢复错误。它可能是因为数据库文件(如BSD兼容的HOSTS、SERVICES或PROTOCOLS文件)找不到,或DNS请求应服务器有严重错误而返回。
WSANO_DATA11004Valid name, no data record of requested type.请求的名字合法并且在数据库中找到了,但它没有正确的关联数据用于解析。此错误的通常例子是主机名到地址(使用gethostbyname()或WSAAsyncGetHostByName()函数)的DNS转换请求,返回了MX(Mail eXchanger)记录但是没有A(Address)记录,它指示主机本身是存在的,但是不能直接到达