使用winsock2.h可能出现的两种编译错误

关注

转载最新推荐文章于 2026-03-05 01:00:07 发布 3.5k 阅读 AI 写同款· GEO 优化 ›

QT里的windows.h和winsock2.h重定义错误 windows.h和winsock2.h的相爱相杀的故事，在网络上广为流传，引发无数血案。各种作案场景，前置环境复杂纷繁，其中root原因和发生规律，以及解决方法，大致几种。今天就写上网上没有出现过的解决方法。现场前2天，一同事QT-Creator(msvc编译工具)开发一个远程socket通讯软件，包含 winsock2.h后，编译失败，各种重复winsock2.h里的结构体变量的重复包... 阅读详情

在我初学Windows网络编程时，曾经遇到过两类编译错误（VC6的Build窗口哗哗的显示了102个Errors），都是些类型未定义或者重复定义问题，让我感到很郁闷。这两种错误情况下的第一条错误信息分别为：

错误情形1：mswsock.h(69) : error C2065: 'SOCKET' : undeclared identifier
错误情形2：winsock2.h(99) : error C2011: 'fd_set' : 'struct' type redefinition

后来，我静下心来仔细分析一下错误提示及相关文件，终于找到了原因。

我们知道，Windows网络编程至少需要两个头文件：winsock2.h和windows.h，而在WinSock2.0之前还存在一个老版本的winsock.h。正是这三个头文件的包含顺序，导致了上述问题的出现。

先让我们看看winsock2.h的内容，在文件开头有如下宏定义：

#ifndef _WINSOCK2API_
#define _WINSOCK2API_
#define _WINSOCKAPI_ /* Prevent inclusion of winsock.h in windows.h */

_WINSOCK2API_很容易理解，这是最常见的防止头文件重复包含的保护措施。_WINSOCKAPI_的定义则是为了阻止对老文件winsock.h的包含，即是说，如果用户先包含了winsock2.h就不允许再包含winsock.h了，否则会导致类型重复定义。这是怎样做到的呢？很简单，因为winsock.h的头部同样存在如下的保护措施：

#ifndef _WINSOCKAPI_
#define _WINSOCKAPI_

再回过头来看winsock2.h，在上述内容之后紧跟着如下宏指令：

/*
* Pull in WINDOWS.H if necessary
*/
#ifndef _INC_WINDOWS
#include <windows.h>
#endif /* _INC_WINDOWS */

其作用是如果用户没有包含windows.h（_INC_WINDOWS在windows.h中定义）就自动包含它，以定义WinSock2.0所需的类型和常量等。

现在切换到windows.h，查找winsock，我们会惊奇的发现以下内容：

#if(_WIN32_WINNT >= 0x0400)
#include <winsock2.h>
#include <mswsock.h>
#else
#include <winsock.h>
#endif /* _WIN32_WINNT >= 0x0400 */

#endif
// 这里省略掉一部分内容
#endif /* WIN32_LEAN_AND_MEAN */

看到没？windows.h会反向包含winsock2.h或者winsock.h！相互间的包含便是万恶之源！

下面具体分析一下问题是怎么发生的。

错误情形1：我们在自己的工程中先包含winsock2.h再包含windows.h，如果WIN32_LEAN_AND_MEAN未定义且_WIN32_WINNT大于或等于0x400，那么windows.h会在winsock2.h开头被自动引入，而windows.h又会自动引入mswsock.h，此时，mswsock.h里所用的socket类型还尚未定义，因此会出现类型未定义错误。

错误情形2：先包含windows.h再包含winsock2.h，如果WIN32_LEAN_AND_MEAN未定义且_WIN32_WINNT未定义或者其版本号小于0x400，那么windows.h会自动导入旧有的winsock.h，这样再当winsock2.h被包含时便会引起重定义。

这里要说明的是，宏WIN32_LEAN_AND_MEAN的作用是减小win32头文件尺寸以加快编译速度，一般由AppWizard在stdafx.h中自动定义。_WIN32_WINNT的作用是开启高版本操作系统下的特殊函数，比如要使用可等待定时器（WaitableTimer），就得要求_WIN32_WINNT的值大于或等于0x400。因此，如果你没有遇到上述两个问题，很可能是你没有在这些条件下进行网络编程。

问题还没有结束，要知道除了VC自带windows库文件外，MS的Platform SDK也含有这些头文件。我们很可能发现在之前能够好好编译的程序在改变了windows头文件包含路径后又出了问题。原因很简单，Platform SDK中的windows.h与VC自带的文件存在差异，其相同位置的代码如下：

#ifndef WIN32_LEAN_AND_MEAN
#include <cderr.h>
#include <dde.h>
#include <ddeml.h>
#include <dlgs.h>
#ifndef _MAC
#include <lzexpand.h>
#include <mmsystem.h>
#include <nb30.h>
#include <rpc.h>
#endif
#include <shellapi.h>
#ifndef _MAC
#include <winperf.h>
#include <winsock.h> // 这里直接包含winsock.h
#endif
#ifndef NOCRYPT
#include <wincrypt.h>
#include <winefs.h>
#include <winscard.h>
#endif

#ifndef NOGDI
#ifndef _MAC
#include <winspool.h>
#ifdef INC_OLE1
#include <ole.h>
#else
#include <ole2.h>
#endif /* !INC_OLE1 */
#endif /* !MAC */
#include <commdlg.h>
#endif /* !NOGDI */
#endif /* WIN32_LEAN_AND_MEAN */

唉，我们不禁要问MS为什么要搞这么多花样，更让人气愤的是，既然代码不一样，windows.h里却没有任何一个宏定义能够帮助程序辨别当前使用的文件是VC自带的还是PSDK里的。

后来，我写了一个头文件专门处理winsock2.h的包含问题，名为winsock2i.h，只需在要使用WinSock2.0的源文件里第一个包含此文件即可，不过由于前面提到的问题，当使用PSDK时，需要手工定义一下USING_WIN_PSDK，源码如下：

//
// winsock2i.h - Include winsock2.h safely.
//
// Copyleft 02/24/2005 by freefalcon
//
//
// When WIN32_LEAN_AND_MEAN is not defined and _WIN32_WINNT is LESS THAN 0x400,
// if we include winsock2.h AFTER windows.h or winsock.h, we get some compiling
// errors as following:
// winsock2.h(99) : error C2011: 'fd_set' : 'struct' type redefinition
//
// When WIN32_LEAN_AND_MEAN is not defined and _WIN32_WINNT is NOT LESS THAN 0x400,
// if we include winsock2.h BEFORE windows.h, we get some other compiling errors:
// mswsock.h(69) : error C2065: 'SOCKET' : undeclared identifier
//
// So, this file is used to help us to include winsock2.h safely, it should be
// placed before any other header files.
//

#ifndef _WINSOCK2API_

// Prevent inclusion of winsock.h
#ifdef _WINSOCKAPI_
#error Header winsock.h is included unexpectedly.
#endif

// NOTE: If you use Windows Platform SDK, you should enable following definition:
// #define USING_WIN_PSDK

#if !defined(WIN32_LEAN_AND_MEAN) && (_WIN32_WINNT >= 0x0400) && !defined(USING_WIN_PSDK)
#include <windows.h>
#else
#include <winsock2.h>
#endif

#endif//_WINSOCK2API_

收录于