简介：这份资源面向在 Windows 平台使用 Visual Studio 2017 进行网络编程的开发者，聚焦「网线插入/拔出状态检测」这一具体问题，适合已具备 C++ 基础、希望快速落地网络接口监控功能的中级学习者。包内共 27 个文件，压缩包约 14.93MB，以 cpp 与 h 源码文件为核心，辅以 vcxproj、sln、filters 等 VS 工程配置，以及 exe、pdb、ilk、obj 等编译产物和 tlog、log 等构建日志，构成一个可直接打开编译的完整示例工程。资源围绕 GetAdaptersAddresses 获取适配器列表、遍历 OperStatus 判断连接状态展开，并涉及 WM_DEVICECHANGE 消息与 RegisterDeviceNotification 的事件驱动思路，可帮助读者理解多网卡、有线与无线切换等场景下的处理要点。目前已有 876 人学习下载，适合作为网络状态监测功能的参考实现与排错起点。
1. 网线插拔检测：一个被低估的 Windows 桌面刚需
做工业上位机或者内网工具的时候，经常遇到一个很朴素的需求：界面角落要显示当前网线到底插没插。用户不会关心 IP 配没配、路由通不通，他只想知道“网线掉了没有”。这个需求听起来简单，真动手才发现坑不少——用 ping 网关判断？网线插着但交换机没通电照样 ping 不通；用InternetGetConnectedState？它反映的是“有没有可用连接”，Wi-Fi 开着就永远返回真。所以这份基于 VS2017 + Windows 的网线插入状态检测工程，价值就在于把“物理链路层”的插拔状态单独拎出来判断，而不是被上层网络配置干扰。它适合写 MFC/Win32 上位机的开发者，也适合任何需要在 Windows 桌面程序里做链路状态指示的场景。下面按“能干什么 → 怎么跑 → 怎么改”的顺序，把这个工程的骨架和关键代码拆开讲。
2. 工程结构与技术选型：为什么是 VS2017 + Win32 API
2.1 目录与工程组织
这个工程是标准的 VS2017 C++ 桌面项目，没有引入任何第三方库，全部依赖 Windows SDK 自带的头文件和库。典型结构如下：
CableStateDetect/ ├── CableStateDetect.sln // VS2017 解决方案 ├── CableStateDetect/ │ ├── CableStateDetect.vcxproj // 工程文件，平台工具集 v141 │ ├── main.cpp // 入口，创建窗口与消息循环 │ ├── CableMonitor.h // 链路状态检测封装 │ ├── CableMonitor.cpp // 核心实现 │ ├── resource.h // 资源 ID │ └── CableStateDetect.rc // 窗口、图标、菜单资源 └── README.md工程属性里几个关键设置要留意：平台工具集选Visual Studio 2017 (v141)，字符集建议用Unicode，链接器附加依赖项里加上Iphlpapi.lib和Ws2_32.lib。这两个库是后面调 IP Helper API 的前提，漏了会在链接阶段报一堆LNK2019。我一般还会在CableMonitor.cpp顶部统一#include <winsock2.h>再#include <iphlpapi.h>，顺序反了会和windows.h里的旧定义打架，这是老生常谈但每次新建工程都容易翻车的地方。
2.2 检测思路：从 GetAdaptersAddresses 拿 OperStatus
Windows 判断网线物理插拔，最靠谱的入口是 IP Helper API 里的GetAdaptersAddresses。它返回的IP_ADAPTER_ADDRESSES结构体里有个OperStatus字段，取值IfOperStatusUp表示链路已连通（网线插好且对端有信号），IfOperStatusDown表示链路断开。这个状态来自网卡驱动，比任何上层探测都直接。
核心调用长这样：
// 获取所有网卡地址信息，重点看 OperStatus ULONG family = AF_UNSPEC; // 不限定 IPv4/IPv6 ULONG flags = GAA_FLAG_INCLUDE_PREFIX; ULONG bufLen = 16 * 1024; // 初始缓冲区，不够会自动扩 std::vector<BYTE> buffer(bufLen); PIP_ADAPTER_ADDRESSES pAddrs = nullptr; ULONG ret = GetAdaptersAddresses(family, flags, nullptr, reinterpret_cast<PIP_ADAPTER_ADDRESSES>(buffer.data()), &bufLen); if (ret == ERROR_BUFFER_OVERFLOW) { buffer.resize(bufLen); // 缓冲区不够，按返回长度重开 pAddrs = reinterpret_cast<PIP_ADAPTER_ADDRESSES>(buffer.data()); ret = GetAdaptersAddresses(family, flags, nullptr, pAddrs, &bufLen); } if (ret != NO_ERROR) { return false; // 调用失败，按断开处理 }参数说明：family传AF_UNSPEC是为了同时覆盖有线和无线网卡；flags里加GAA_FLAG_INCLUDE_PREFIX是为了拿到前缀信息，虽然判断插拔用不上，但后续要显示 IP 时省得再调一次。bufLen是典型的“先给个够用的大小、溢出再扩”模式，别图省事传固定小缓冲区，机器上网卡多的时候必翻车。
拿到链表后遍历，用IfType过滤掉回环、隧道等虚拟网卡，只保留以太网类型：
for (PIP_ADAPTER_ADDRESSES p = pAddrs; p; p = p->Next) { // 只关心以太网，排除 Loopback / Tunnel / Wi-Fi if (p->IfType != IF_TYPE_ETHERNET_CSMACD) continue; // OperStatus 才是物理链路状态 bool cableUp = (p->OperStatus == IfOperStatusUp); // 记录到界面或日志 }IF_TYPE_ETHERNET_CSMACD这个常量值对应 6，是以太网的标准类型。如果你的机器上有 USB 网卡或者虚拟网卡（VMware、Hyper-V），它们可能也报成以太网类型，所以实际工程里我一般再加一层p->PhysicalAddressLength > 0和描述字符串过滤，避免把虚拟网卡当成物理网线。
2.3 定时轮询与界面刷新
GetAdaptersAddresses是同步查询，没有事件回调，所以插拔检测靠定时器轮询。工程里用SetTimer起一个 1 秒周期的定时器，在WM_TIMER里调一次检测函数，状态变化时更新界面文字或图标颜色。
// 窗口创建时启动定时器，1 秒一次 SetTimer(hWnd, TIMER_ID_CABLE, 1000, nullptr); // 消息循环里处理 case WM_TIMER: if (wParam == TIMER_ID_CABLE) { bool up = IsCableConnected(); UpdateCableIndicator(hWnd, up); // 改文字/换图标 } break;1 秒的间隔是权衡结果：太快没必要，网卡状态变化本身有延迟；太慢用户会觉得“拔了线界面还亮着”。如果做的是产线测试工具，对实时性要求高，可以缩到 300～500 毫秒，但要注意别在定时器里做重活，否则界面会卡。UpdateCableIndicator里只做SetWindowText或InvalidateRect，别在里面再调一次网络查询。
3. 从零跑起来：编译、调试与状态验证
3.1 环境准备与编译步骤
先确认 VS2017 装了“使用 C++ 的桌面开发”工作负载，Windows SDK 版本选 10.0.17763 或更高都行。打开.sln后检查两处：工程属性 → 链接器 → 输入 → 附加依赖项，确认有Iphlpapi.lib;Ws2_32.lib；C/C++ → 预处理器，确认没漏_WIN32_WINNT=0x0601（Win7 及以上）。然后直接 F7 编译，F5 调试。
如果编译报GetAdaptersAddresses未声明，八成是#include <iphlpapi.h>没加或者加在了windows.h前面。正确顺序是：
#include <winsock2.h> // 必须先于 windows.h #include <windows.h> #include <iphlpapi.h> #pragma comment(lib, "iphlpapi.lib") #pragma comment(lib, "ws2_32.lib")#pragma comment是偷懒写法，等价于在工程属性里加依赖项，二选一即可。我倾向用 pragma，换机器、换解决方案时不用重新配属性，少一次踩坑。
3.2 用真实插拔验证状态
跑起来后，界面会显示当前网线状态。验证方法很直接：拔掉网线，等 1～2 秒看界面是否变成“断开”；插回去，再等 1～2 秒看是否恢复“已连接”。这里有个细节——有些主板网卡在拔线后OperStatus不会立刻变Down，驱动有几百毫秒到一两秒的延迟，所以别用“拔线瞬间必须变”来验收，给 2 秒容差。
如果想在没物理网线的环境下调试，可以在虚拟机里给网卡做“连接/断开”操作，效果等价于插拔。但注意虚拟机的虚拟网卡IfType可能不是IF_TYPE_ETHERNET_CSMACD，需要临时放宽过滤条件，否则会一直显示断开，误以为代码有问题。
3.3 多网卡场景的处理
台式机双网卡、笔记本有线加无线是常态。工程里IsCableConnected的语义要提前定清楚：是“任意一块有线网卡连通”还是“指定某块网卡连通”。前者实现简单，遍历时遇到第一个Up就返回真；后者需要按AdapterName（GUID）或描述字符串匹配。
// 指定网卡：按描述关键字匹配，比如 "Realtek" bool IsSpecificCableUp(const std::wstring& keyword) { // ... 省略 GetAdaptersAddresses 调用 for (PIP_ADAPTER_ADDRESSES p = pAddrs; p; p = p->Next) { if (p->IfType != IF_TYPE_ETHERNET_CSMACD) continue; if (p->Description && wcsstr(p->Description, keyword.c_str())) { return p->OperStatus == IfOperStatusUp; } } return false; }Description是网卡在设备管理器里显示的名字，用它做关键字匹配比记 GUID 友好得多。缺点是换网卡型号后关键字要改，所以正式项目里我一般把关键字做成配置项，而不是写死在代码里。
4. 核心代码拆解：检测函数的完整实现与参数细节
4.1 封装一个可复用的检测类
把检测逻辑收进一个类，比散在窗口过程里好维护。CableMonitor只暴露一个Query()方法，内部缓存上一次状态，状态变化时通过回调通知界面，避免界面层反复比对。
class CableMonitor { public: using Callback = std::function<void(bool up)>; explicit CableMonitor(Callback cb) : cb_(std::move(cb)) {} // 返回当前是否有有线链路连通 bool Query() { bool up = QueryInternal(); if (up != lastState_) { // 只在变化时回调 lastState_ = up; if (cb_) cb_(up); } return up; } private: bool QueryInternal(); Callback cb_; bool lastState_ = false; };std::function做回调的好处是界面层可以传 lambda，把“更新哪个控件”这件事留在界面代码里，检测类不依赖任何 UI 头文件。lastState_初值设false，第一次查询如果本来就是连通，会触发一次回调，正好用来初始化界面，不用额外写初始化逻辑。
4.2 QueryInternal 的完整实现
bool CableMonitor::QueryInternal() { ULONG flags = GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_DNS_SERVER; // 只要链路信息，跳过无关项 ULONG bufLen = 16 * 1024; std::vector<BYTE> buf(bufLen); PIP_ADAPTER_ADDRESSES pAddrs = nullptr; ULONG ret = GetAdaptersAddresses(AF_UNSPEC, flags, nullptr, reinterpret_cast<PIP_ADAPTER_ADDRESSES>(buf.data()), &bufLen); if (ret == ERROR_BUFFER_OVERFLOW) { buf.resize(bufLen); pAddrs = reinterpret_cast<PIP_ADAPTER_ADDRESSES>(buf.data()); ret = GetAdaptersAddresses(AF_UNSPEC, flags, nullptr, pAddrs, &bufLen); } else { pAddrs = reinterpret_cast<PIP_ADAPTER_ADDRESSES>(buf.data()); } if (ret != NO_ERROR) return false; for (PIP_ADAPTER_ADDRESSES p = pAddrs; p; p = p->Next) { if (p->IfType != IF_TYPE_ETHERNET_CSMACD) continue; if (p->OperStatus == IfOperStatusUp) return true; } return false; }这里flags用了三个SKIP，作用是减少返回数据量、加快查询。GAA_FLAG_SKIP_DNS_SERVER尤其值得加，某些机器 DNS 配置异常时，不跳过会拖慢调用。bufLen溢出重试的逻辑必须保留，网卡多、IPv6 地址多的时候 16KB 不一定够，直接截断会漏掉后面的网卡，表现为“明明插着线却显示断开”，这种玄学问题查起来很费时间。
4.3 状态变化的最小刷新策略
界面刷新最忌讳每次定时器都重绘。UpdateCableIndicator里先比对当前显示的文字，相同就直接返回：
void UpdateCableIndicator(HWND hWnd, bool up) { static bool shown = false; static bool inited = false; if (inited && shown == up) return; // 状态没变，不碰控件 shown = up; inited = true; SetDlgItemText(hWnd, IDC_CABLE_STATE, up ? L"网线：已连接" : L"网线：已断开"); }static变量在这里够用，因为只有一个窗口实例。如果工程里有多窗口或多实例，就把这两个变量挪进窗口类的成员里。别小看这一层判断，定时器 1 秒一次、界面控件多的时候，无谓的SetWindowText会引发重绘和闪烁，用户看着就像界面在抖。
5. 避坑与排查：插拔检测里最容易翻车的几件事
5.1 现象：Wi-Fi 开着时永远显示“已连接”
原因：检测函数没有过滤网卡类型，把无线网卡的OperStatus也算进去了，而无线网卡只要连着 AP 就是Up。解决：遍历时严格用IfType == IF_TYPE_ETHERNET_CSMACD过滤，并且对虚拟网卡再加PhysicalAddressLength > 0判断。如果机器上有 USB 转网口，它的类型也是以太网，属于正常物理链路，保留即可。
5.2 现象：拔线后状态要好几秒才变
原因：网卡驱动上报链路状态有延迟，加上 1 秒轮询周期，最坏情况叠加到 2～3 秒。解决：把定时器缩到 500 毫秒能改善观感，但别指望做到“瞬时”。验收标准要按“2 秒内变化”来定，而不是“立刻”。另外别在WM_TIMER里做Sleep等待，那会把整个消息循环卡死。
5.3 现象：编译通过但运行崩溃在 GetAdaptersAddresses
原因：bufLen传了 0 或者缓冲区指针为空，函数内部解引用空指针。解决：初始bufLen给足 16KB，缓冲区用std::vector<BYTE>保证生命周期覆盖整个调用和后续遍历。注意pAddrs指向的是buf的内部内存，buf一旦析构或resize导致重新分配，pAddrs就悬空了，所以遍历必须在buf有效期内完成。
5.4 现象：双网卡机器上状态来回跳
原因：两块有线网卡一块插着一块拔了，QueryInternal遇到第一个Up就返回真，但遍历顺序不固定，导致结果不稳定。解决：明确语义——要么“任意一块连通即算连通”（遇到Up立即返回，本身稳定），要么“指定网卡”，按描述匹配。最怕的是代码里一会儿按第一块、一会儿按最后一块，那状态就会跳。把语义写进函数注释，后面接手的人少踩一次。
5.5 现象：Release 版正常、Debug 版偶发失败
原因：Debug 版对未初始化内存更敏感，IP_ADAPTER_ADDRESSES链表里某些字段在旧系统上可能为空，直接解引用p->Description会崩。解决：所有指针字段访问前判空，Description、FriendlyName、DnsServerList都按可能为nullptr处理。这类问题在开发机上复现不了，到了客户现场才炸，属于典型的血泪经验。
6. 二次开发：把检测能力接进真实上位机
拿到这个工程后，最常见的改造方向有三个：把状态接到托盘图标、把插拔事件写进日志、把检测结果通过串口或 TCP 上报给主控。前两个改动量小，第三个要注意线程模型。
接托盘图标时，在状态回调里调Shell_NotifyIcon改图标即可，但Shell_NotifyIcon必须在创建托盘的同一线程调用，所以回调不能跨线程直接刷 UI。我的做法是回调里PostMessage给主窗口，由窗口过程统一处理，这样检测线程和 UI 线程彻底解耦。
写日志时，插拔事件的时间戳很关键。别在Query()里直接写文件，IO 可能阻塞定时器。用一个std::deque做缓冲，定时器里只push，另起一个低优先级线程或利用空闲消息批量落盘。日志格式建议带上网卡描述和OperStatus原值，出问题时能直接看出是哪块网卡、什么状态。
如果要把状态上报给主控，注意GetAdaptersAddresses本身不是线程安全的调用习惯问题，而是它返回的缓冲区是调用方持有的，多线程各自调用互不影响，但别共享同一个std::vector缓冲区。每个线程用自己的局部缓冲区，或者加锁串行化，二选一，别混着来。
改造后的验证方法我一般固定三步：先在开发机上拔插三次确认状态和日志都对；再在双网卡机器上验证语义符合预期；最后在目标机器上跑满 24 小时看有没有内存增长——GetAdaptersAddresses每次调用都会分配内部内存，虽然系统会回收，但缓冲区管理写错的话，长时间跑会慢慢涨。从那以后我每次给这类轮询检测加功能，都强制先跑一遍 24 小时稳定性，再谈界面好不好看。希望帮到你。
本文还有配套的精品资源，点击获取
