C++如何获取系统的网络适配器MAC地址 Windows API跨平台方案

来源：建站技术作者：沙月恵奈‌头衔：网络博主
导读：本期聚焦于小伙伴创作的《C++如何获取系统的网络适配器MAC地址 Windows API跨平台方案》，敬请观看详情，探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《C++如何获取系统的网络适配器MAC地址 Windows API跨平台方案》有用，将其分享出去将是对创作者最好的鼓励。

在C++开发中，获取系统网络适配器的MAC地址是网络配置检测、设备唯一标识生成等场景的常用需求，Windows系统下可以通过系统提供的网络相关API实现该功能，同时需要结合不同系统的特性做适配处理。

C++如何获取系统的网络适配器MAC地址 Windows API跨平台方案

Windows API获取MAC地址的核心思路

Windows系统下获取MAC地址主要依赖IP Helper API中的相关函数，核心流程是先获取系统中所有网络适配器的信息，再从信息中提取对应适配器的MAC地址数据。主要用到的API包括GetAdaptersInfo和GetAdaptersAddresses，前者兼容性更好，支持更早的Windows系统版本，后者功能更丰富，支持更多网络配置信息的获取。

使用GetAdaptersInfo实现MAC地址获取

GetAdaptersInfo函数可以获取本地计算机上所有网络适配器的信息，返回的结构体IP_ADAPTER_INFO中包含适配器的MAC地址、IP地址、适配器名称等关键信息。使用该函数的步骤是先调用一次获取所需缓冲区大小，再分配缓冲区后再次调用获取完整信息。

以下是完整的实现代码：

#include <iostream>
#include <windows.h>
#include <iphlpapi.h>
#include <vector>
#include <iomanip>

// 链接iphlpapi库
#pragma comment(lib, "iphlpapi.lib")
// 链接ws2_32库，部分网络相关函数依赖
#pragma comment(lib, "ws2_32.lib")

int main() {
    // 定义获取适配器信息所需的缓冲区
    PIP_ADAPTER_INFO pAdapterInfo = nullptr;
    ULONG ulOutBufLen = 0;
    DWORD dwRetVal = 0;

    // 第一次调用获取所需缓冲区大小
    dwRetVal = GetAdaptersInfo(pAdapterInfo, &ulOutBufLen);
    if (dwRetVal == ERROR_BUFFER_OVERFLOW) {
        // 分配足够大小的缓冲区
        pAdapterInfo = (PIP_ADAPTER_INFO)malloc(ulOutBufLen);
        if (pAdapterInfo == nullptr) {
            std::cerr << "分配内存失败" << std::endl;
            return 1;
        }
    } else if (dwRetVal != NO_ERROR) {
        std::cerr << "获取适配器信息失败，错误码: " << dwRetVal << std::endl;
        return 1;
    }

    // 第二次调用获取完整的适配器信息
    dwRetVal = GetAdaptersInfo(pAdapterInfo, &ulOutBufLen);
    if (dwRetVal == NO_ERROR) {
        PIP_ADAPTER_INFO pAdapter = pAdapterInfo;
        // 遍历所有网络适配器
        while (pAdapter != nullptr) {
            std::cout << "适配器名称: " << pAdapter->AdapterName << std::endl;
            std::cout << "适配器描述: " << pAdapter->Description << std::endl;
            std::cout << "MAC地址: ";
            // 遍历MAC地址的每个字节，以十六进制形式输出
            for (UINT i = 0; i < pAdapter->AddressLength; i++) {
                if (i == pAdapter->AddressLength - 1) {
                    std::cout << std::hex << std::setw(2) << std::setfill('0') << (int)pAdapter->Address[i];
                } else {
                    std::cout << std::hex << std::setw(2) << std::setfill('0') << (int)pAdapter->Address[i] << ":";
                }
            }
            std::cout << std::dec << std::endl;
            std::cout << "------------------------" << std::endl;
            pAdapter = pAdapter->Next;
        }
    } else {
        std::cerr << "获取适配器信息失败，错误码: " << dwRetVal << std::endl;
    }

    // 释放分配的缓冲区
    if (pAdapterInfo != nullptr) {
        free(pAdapterInfo);
        pAdapterInfo = nullptr;
    }
    return 0;
}

关键结构体与API说明

IP_ADAPTER_INFO结构体中与MAC地址相关的核心字段如下：

  • AddressLength：MAC地址的字节长度，通常为6字节
  • Address：存储MAC地址的字节数组，每个元素对应MAC地址的一位
  • AdapterName：适配器的唯一标识名称
  • Description：适配器的描述信息，比如网卡型号

GetAdaptersInfo函数的返回值需要处理两种情况，第一次调用返回ERROR_BUFFER_OVERFLOW是正常情况，说明需要分配更大的缓冲区，只有返回NO_ERROR时才表示成功获取到适配器信息。

跨平台方案适配思路

上述基于Windows API的方案仅能在Windows系统下运行，无法实现跨平台，若需要支持Linux、macOS等系统，需要针对不同系统使用对应的系统API，然后通过条件编译实现不同平台的代码适配。

不同平台的API选择

系统平台获取MAC地址的常用方式
WindowsIP Helper API的GetAdaptersInfo或GetAdaptersAddresses
Linux读取/sys/class/net/目录下的网卡信息，或通过getifaddrs函数获取
macOS使用sysctl函数获取网络接口信息，或getifaddrs函数

条件编译实现跨平台适配

可以通过预定义宏判断当前编译的系统，然后分别编写不同平台的实现代码，以下是一个简单的适配框架：

#include <iostream>
#include <vector>
#include <string>

// 定义存储MAC地址的结构体
struct MacAddressInfo {
    std::string adapterName;
    std::string adapterDesc;
    std::vector<unsigned char> macAddress;
};

// Windows平台实现
#ifdef _WIN32
#include <windows.h>
#include <iphlpapi.h>
#pragma comment(lib, "iphlpapi.lib")
#pragma comment(lib, "ws2_32.lib")

std::vector<MacAddressInfo> getMacAddressesWin() {
    std::vector<MacAddressInfo> result;
    PIP_ADAPTER_INFO pAdapterInfo = nullptr;
    ULONG ulOutBufLen = 0;
    DWORD dwRetVal = GetAdaptersInfo(pAdapterInfo, &ulOutBufLen);
    if (dwRetVal == ERROR_BUFFER_OVERFLOW) {
        pAdapterInfo = (PIP_ADAPTER_INFO)malloc(ulOutBufLen);
    }
    if (pAdapterInfo == nullptr) return result;
    dwRetVal = GetAdaptersInfo(pAdapterInfo, &ulOutBufLen);
    if (dwRetVal == NO_ERROR) {
        PIP_ADAPTER_INFO pAdapter = pAdapterInfo;
        while (pAdapter != nullptr) {
            MacAddressInfo info;
            info.adapterName = pAdapter->AdapterName;
            info.adapterDesc = pAdapter->Description;
            for (UINT i = 0; i < pAdapter->AddressLength; i++) {
                info.macAddress.push_back(pAdapter->Address[i]);
            }
            result.push_back(info);
            pAdapter = pAdapter->Next;
        }
    }
    free(pAdapterInfo);
    return result;
}
#endif

// Linux平台实现
#ifdef __linux__
#include <sys/ioctl.h>
#include <net/if.h>
#include <unistd.h>
#include <cstring>
#include <fstream>

std::vector<MacAddressInfo> getMacAddressesLinux() {
    std::vector<MacAddressInfo> result;
    // 读取/sys/class/net/目录下的网卡信息
    // 实际实现中可以遍历该目录下的文件，读取address文件获取MAC地址
    // 此处为简化示例，仅展示框架逻辑
    return result;
}
#endif

// 统一对外接口
std::vector<MacAddressInfo> getMacAddresses() {
#ifdef _WIN32
    return getMacAddressesWin();
#elif defined(__linux__)
    return getMacAddressesLinux();
#else
    // 其他平台实现
    return std::vector<MacAddressInfo>();
#endif
}

int main() {
    auto macList = getMacAddresses();
    for (auto &info : macList) {
        std::cout << "适配器: " << info.adapterDesc << std::endl;
        std::cout << "MAC: ";
        for (size_t i = 0; i < info.macAddress.size(); i++) {
            if (i == info.macAddress.size() - 1) {
                std::cout << std::hex << (int)info.macAddress[i];
            } else {
                std::cout << std::hex << (int)info.macAddress[i] << ":";
            }
        }
        std::cout << std::dec << std::endl;
    }
    return 0;
}

常见问题与注意事项

  • 部分虚拟网络适配器也会返回MAC地址，若只需要物理网卡信息，可以通过适配器的描述信息做过滤，比如过滤包含Virtual、VMware等关键词的适配器
  • MAC地址可能被用户手动修改，因此不能作为绝对唯一的设备标识使用
  • 使用GetAdaptersInfo时需要链接对应的系统库，否则会出现链接错误
  • 跨平台实现时需要注意不同系统下MAC地址的字节序问题，避免输出格式错误
获取MAC地址属于系统级操作，在部分系统中需要对应的权限，比如Linux系统下普通用户可能无法读取部分网卡的信息，需要提升权限后运行程序。

C++Windows_APInetwork_adapterMAC_address修改时间：2026-06-17 08:57:40

免责声明：​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰，观点力求客观中立。本站旨在免费分享，内容仅供个人学习、研究或参考使用。若引用了第三方作品，版权归原作者所有。如内容涉及您的权益，请联系我们处理。

上一篇C++ 移动构造函数（Move Constructor）是什么？如何确保异常安全性

下一篇怎样用结构体实现简单元组 std::tuple的替代方案实现

猜你喜欢

内容垂直聚焦
专注技术核心技术栏目，确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计，为用户提供无干扰的纯技术知识沉淀，精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进，构建清晰学习路径，帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈，深入技术细节与实践难点。无论是数据库优化还是服务器配置，均结合真实场景与代码示例进行剖析，致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程，从数据库操作到服务器运维，形成完整闭环，一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性，步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目，显著缩短从学习到实践的距离，快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代，紧跟主流技术发展趋势，为用户提供经久不衰的学习价值。

负责任网站 - 免责声明 - 隐私政策 - 网站地图

举报邮箱：chomcom@qq.com

Copyright (C) www.ipipp.com All Rights Reserved.