从零精通Windows网络编程：Winsock套接字初始化与核心API全解析

咸鱼_要_翻身

于 2025-05-23 11:32:08 发布

阅读量1.1k

点赞数 17

分类专栏： Linux 文章标签： windows 网络 websocket

本文链接：https://blog.csdn.net/2302_80871796/article/details/148157451

版权

Linux 专栏收录该内容

18 篇文章

订阅专栏

引言

在Windows环境下开发网络应用，Winsock套接字（Windows Sockets）是绕不开的核心技术。无论是构建即时聊天工具、网络游戏服务器，还是物联网设备通信，理解Winsock的初始化和核心API是实现可靠网络通信的基础。本文将从零开始，手把手教你完成Winsock的初始化实训，并深入解析每一个关键知识点，确保你不仅能运行代码，更能理解背后的原理。注：本博客基于魏勍颋、邹春华、陈强老师等编著的《计算机网络实验与实训教程》作为参考进行实验，开发环境为Windows 11（操作系统） + VS2022（开发环境）

1. 初始化Winsock：WSAStartup

2. 输出Winsock信息

3. 清理资源：WSACleanup

4. 完整代码示例（winsockinit.cpp）

一、Winsock基础概念

1. 什么是套接字（Socket）？

套接字是网络通信的端点，用于不同主机间的进程双向通信。其核心结构包含以下信息：

协议（TCP/UDP），本地地址（IP地址），本地端口，远程地址，远程端口

流套接字（SOCK_STREAM）：面向连接的（如TCP），它提供双向的、有序的、无差错、无重复并且无记录边界的数据流服务，适用于处理大量数据，提供可靠的服务。
数据报套接字（SOCK_DGRAM）：无连接的（如UDP），它支持双向的数据传输，具有开销小、数据传输效率高的特点，但不保证数据传输的可靠性、有序性和无重复性，适合少量数据传输、以及时间敏感的音视频多媒体数据传输。
原始套接字（SOCK_RAW）：直接访问底层协议（如IP/ICMP），用于通信与协议开发。

2.Winsock套接字

是Windows操作系统环境下的套接字网络应用程序编程接口（API）。
Windows Sockets 1.1版本：winsock.h、wsock32.dll（需添加静态链接函数库wsock32.lib ）
Windows Sockets 2.0版本：winsock2.h、ws2_32.dll（需添加静态链接函数库ws2_32.lib）

3. Winsock版本选择

Winsock 1.1：经典版本，支持基础TCP/UDP通信。
Winsock 2.0+：支持异步I/O、IPv6、服务质量（QoS）等高级功能，完全兼容1.1。
推荐使用2.0版本：开发时统一使用winsock2.h和ws2_32.lib，避免版本冲突。

二、开发环境配置

1. 创建Visual Studio项目

打开VS2022 → 新建项目 → 选择“控制台应用”（C++）。
输入项目名称（如winsockinit），点击“创建”。

2. 配置Winsock静态库

方法一（代码内配置）：在代码首行添加编译指令：
```
#pragma comment(lib, "ws2_32.lib")
```
方法二（项目属性配置）：
1. 右键项目 → 属性 → 链接器 → 输入 → 附加依赖项。
2. 添加ws2_32.lib → 应用并确定。

三、Winsock 的库函数

1、初始化套接字 WSAStartup

WSADATA 结构体规范定义

宏定义

#define WSADESCRIPTION_LEN  256  // Winsock 描述信息的最大长度
#define WSASYS_STATUS_LEN   128  // 系统状态信息的最大长度

结构体定义

typedef struct WSAData {
    WORD           wVersion;        // 主版本号（实际使用的Winsock版本）
    WORD           wHighVersion;    // 副版本号（支持的最高版本）
    
    char           szDescription[WSADESCRIPTION_LEN + 1];  // Winsock 库描述信息（以NULL结尾的字符串）
    char           szSystemStatus[WSASYS_STATUS_LEN + 1];  // 系统状态信息（以NULL结尾的字符串）
    
    unsigned short iMaxSockets;     // 最大支持的Socket数量（已弃用，现代系统返回0）
    unsigned short iMaxUdpDg;       // 最大UDP数据报大小（已弃用，现代系统返回0）
    
    char*          lpVendorInfo;    // 厂商特定信息（通常为NULL）
} WSADATA;

字段说明

字段名	数据类型	说明
`wVersion`	`WORD`	实际使用的Winsock版本（低字节为主版本，高字节为副版本，如`0x0202`表示2.2）
`wHighVersion`	`WORD`	系统支持的最高Winsock版本（格式同`wVersion`）
`szDescription`	`char[257]`	Winsock实现的描述信息（如`"WinSock 2.0"`）
`szSystemStatus`	`char[129]`	系统状态（如`"Running"`，可能为空字符串）
`iMaxSockets`	`unsigned short`	已弃用：理论上支持的最大Socket数量，现代系统返回0（表示动态分配）
`iMaxUdpDg`	`unsigned short`	已弃用：理论上支持的最大UDP数据报大小，现代系统返回0（表示动态调整）
`lpVendorInfo`	`char*`	厂商特定信息指针，通常为`NULL`

2、创建套接字 socket

3、WSASocket

4、设置套接字选项setsockopt

5、关闭套接字closesocket

6、注销套接字WSACleanup

四、核心API详解与代码实现

1. 初始化Winsock：`WSAStartup`

#include <winsock2.h>
#include <ws2tcpip.h>

int main() {
    WSADATA wsaData;
    // 请求2.2版本，wsaData保存库信息
    int result = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (result != 0) {
        std::cerr << "初始化失败！错误代码: " << result << std::endl;
        return 1;
    }
    // ...后续代码
}

MAKEWORD(2, 2)：宏将主版本号和副版本号组合为0x0202。

WSADATA结构体：包含版本、描述、系统状态等信息：

struct WSAData {
  WORD wVersion;         // 实际使用的版本
  WORD wHighVersion;     // 支持的最高版本
  char szDescription[257]; // 库描述（如"WinSock 2.0"）
  char szSystemStatus[129]; // 系统状态（如"Running"）
  unsigned short iMaxSockets; // 最大Socket数量（已弃用，显示为0）
  unsigned short iMaxUdpDg;  // 最大UDP报文大小（已弃用，显示为0）
};

2. 输出Winsock信息

// 强制转换为int，避免控制台显示乱码
std::cout << "主版本号: " << static_cast<int>(LOBYTE(wsaData.wVersion)) << std::endl;
std::cout << "副版本号: " << static_cast<int>(HIBYTE(wsaData.wVersion)) << std::endl;
std::cout << "描述信息: " << wsaData.szDescription << std::endl;
std::cout << "系统状态: " << wsaData.szSystemStatus << std::endl;

3. 清理资源：`WSACleanup`

WSACleanup(); // 释放Winsock资源

4. 完整代码示例（winsockinit.cpp）

// winsockinit.cpp : 此文件包含 "main" 函数。程序执行将在此处开始并结束。
//

// 包含标准输入输出流库
#include <iostream>
// 包含Winsock 2.0头文件
#include <winsock2.h>
// 包含Winsock扩展头文件（TCP/IP协议支持）
#include <ws2tcpip.h>

// 告诉链接器需要链接ws2_32.lib库文件
#pragma comment(lib, "ws2_32.lib")

// 主函数，程序入口点
int main()
{
    // 声明WSADATA结构体变量，用于存储Winsock初始化信息
    WSADATA wsaData;
    
    // 初始化Winsock库，请求2.2版本
    // MAKEWORD(2,2)表示主版本2，副版本2
    // 如果初始化失败，返回非0值
    if (WSAStartup(MAKEWORD(2, 2), &wsaData) != 0) {
        // 输出错误信息，WSAGetLastError()获取具体错误代码
        std::cerr << "初始化失败！错误代码: " << WSAGetLastError() << std::endl;
        // 返回1表示程序异常结束
        return 1;
    }

    // 输出Winsock主版本号
    // LOBYTE提取WORD的低字节，static_cast<int>确保输出为数字
    std::cout << "Winsock 主版本号: " << static_cast<int>(LOBYTE(wsaData.wVersion)) << std::endl;
    // 输出Winsock副版本号
    // HIBYTE提取WORD的高字节
    std::cout << "Winsock 二级版本号: " << static_cast<int>(HIBYTE(wsaData.wVersion)) << std::endl;
    // 输出Winsock库描述信息
    std::cout << "Winsock 描述: " << wsaData.szDescription << std::endl;
    // 输出系统状态信息
    std::cout << "系统状态: " << wsaData.szSystemStatus << std::endl;
    // 输出最大socket数量（现代系统通常返回0，表示动态分配）
    std::cout << "最多打开socket数量: " << wsaData.iMaxSockets << std::endl;
    // 输出最大UDP数据报大小（现代系统通常返回0，表示动态分配）
    std::cout << "最大数据报文大小: " << wsaData.iMaxUdpDg << std::endl;

    // 检查实际使用的版本是否低于请求的2.2版本
    if (LOBYTE(wsaData.wVersion) < 2) {
        // 输出警告信息
        std::cerr << "警告: 当前版本低于请求的2.2版本！" << std::endl;
    }

    // 清理Winsock资源，释放库占用的系统资源
    WSACleanup();
    
    // 返回0表示程序正常结束
    return 0;
}

/*
程序使用说明：
运行程序: Ctrl + F5 或调试 >"开始执行(不调试)"菜单
调试程序: F5 或调试 >"开始调试"菜单

Visual Studio使用技巧:
1. 使用解决方案资源管理器窗口添加/管理文件
2. 使用团队资源管理器窗口连接到源代码管理
3. 使用输出窗口查看生成输出和其他消息
4. 使用错误列表窗口查看错误
5. 转到"项目">"添加新项"以创建新的代码文件，或转到"项目">"添加现有项"以将现有代码文件添加到项目
6. 将来，若要再次打开此项目，请转到"文件">"打开">"项目"并选择.sln文件
*/

五、运行结果与验证

1.编译和运行

点击顶部菜单"生成" > "生成解决方案"
编译成功后，点击"调试" > "开始执行(不调试)"

2. 预期输出

成功运行后，控制台显示：

3. 常见问题解决

版本号显示为方框（□）：
- 原因：控制台编码不匹配或者可能是类型不匹配。
- 解决：第一：添加SetConsoleOutputCP(CP_UTF8);并确保控制台字体支持Unicode（如“Consolas”）。第二：使用static_cast<int>强制类型转化，使其转化为对应类型。
iMaxSockets和iMaxUdpDg为0：
- 原因：现代系统动态分配资源，这两个字段已弃用。