讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

c++如何获取当前系统的所有网络共享盘符及挂载路径列表【实战】

云宇吖_5290

云宇吖_5290

发布时间:2026-04-04 23:15:34

|

288人浏览过

|

来源于php中文网

原创

应使用 WNetEnumResource 配合 WNetOpenEnum 枚举 RESOURCE_CONNECTED 资源,通过 NETRESOURCE 的 lpLocalName 和 lpRemoteName 获取有效网络驱动器,并用 GetDriveType 二次验证类型为 DRIVE_REMOTE 或 DRIVE_NETWORK,确保结果准确可靠。

c++如何获取当前系统的所有网络共享盘符及挂载路径列表【实战】

Windows 下用 WNetEnumResource 枚举已连接的网络驱动器

Windows 系统中,网络共享映射为盘符(如 Z:)后,并不保存在注册表固定位置,也不能靠遍历 GetLogicalDrives() 直接区分本地/网络盘符。真正可靠的方式是调用 Windows 网络 API 的枚举接口:WNetEnumResource 配合 WNetOpenEnum,作用对象是当前会话中“已成功连接”的网络资源(即用户执行过 net use Z: \servershare 或资源管理器手动映射过的)。

关键点在于:必须指定枚举范围为 RESOURCE_CONNECTED,否则会拿到大量未连接或不可见的资源(比如域内所有可见共享),干扰判断。

  • WNetOpenEnum 第二个参数必须传 RESOURCE_CONNECTED,不能用 RESOURCE_REMEMBERED(那是开机自动重连项,不一定当前有效)
  • 返回的每个 NETRESOURCE 结构体中,lpLocalName 字段就是盘符(如 "Z:"),lpRemoteName 是 UNC 路径(如 "\\server\share")
  • 需循环调用 WNetEnumResource,因为一次最多只返回 1024 个条目;缓冲区要动态扩容,否则容易截断
  • 记得最后调用 WNetCloseEnum,否则句柄泄漏(尤其在长期运行的服务中会出问题)

如何区分“真挂载”和“假盘符”(比如 ISO 挂载、OneDrive 同步盘)

仅靠 GetDriveType 返回 DRIVE_REMOTE 并不可靠——某些云同步客户端(如 OneDrive、Google Drive)会伪造该类型,而部分 SMB 共享在特定配置下反而返回 DRIVE_NETWORK 或误判为 DRIVE_FIXED。所以不能跳过 WNetEnumResource 直接查盘符类型。

更稳妥的做法是:先用 WNetEnumResource 拿到所有 RESOURCE_CONNECTED 条目,再对每个 lpLocalName 调用 GetDriveType 做二次确认。若返回非 DRIVE_REMOTE 且非 DRIVE_NETWORK,说明这个盘符虽然出现在网络资源列表里,但当前底层连接可能已失效或被其他机制接管,应过滤掉。

立即学习“C++免费学习笔记(深入)”;

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 常见误报:OneDrive 映射盘符常返回 DRIVE_FIXED,但它不是真实网络共享,lpRemoteName 也为空或非法,直接丢弃
  • 若 lpLocalName 为空(NULL),说明这是无盘符的连接(如 net use * \servershare),这类不计入“盘符列表”,按需跳过
  • UNC 路径需检查是否以 "\\" 开头,避免解析错误(有些旧程序会补全成 "\\server\share",注意双反斜杠转义)

C++ 实操代码片段(带错误处理与内存管理)

#include <windows.h>
#include <winnetwk.h>
#include <vector>
#include <string>
<p>struct NetDriveInfo {
std::string localName;   // e.g. "Z:"
std::string remoteName;  // e.g. "\servershare"
};</p><p>std::vector<NetDriveInfo> GetConnectedNetworkDrives() {
std::vector<NetDriveInfo> result;
HANDLE hEnum = nullptr;
DWORD cbBuffer = 16384;
std::vector<BYTE> buffer(cbBuffer);
DWORD entries = 0;</p><pre class='brush:php;toolbar:false;'>if (WNetOpenEnum(RESOURCE_CONNECTED, RESOURCETYPE_DISK, 0, nullptr, &hEnum) != NO_ERROR) {
    return result;
}

while (true) {
    DWORD result = WNetEnumResource(hEnum, &entries, buffer.data(), &cbBuffer);
    if (result == ERROR_MORE_DATA) {
        buffer.resize(cbBuffer);
        continue;
    } else if (result != NO_ERROR) {
        break;
    }

    NETRESOURCE* pRes = reinterpret_cast<NETRESOURCE*>(buffer.data());
    for (DWORD i = 0; i < entries; ++i) {
        if (pRes[i].dwDisplayType == RESOURCEDISPLAYTYPE_SHARE &&
            pRes[i].lpLocalName && pRes[i].lpRemoteName) {

            std::string local(pRes[i].lpLocalName);
            std::string remote(pRes[i].lpRemoteName);

            // 再次验证盘符有效性
            UINT dt = GetDriveType((local + "\\").c_str());
            if (dt == DRIVE_REMOTE || dt == DRIVE_NETWORK) {
                result.push_back({local, remote});
            }
        }
    }
    break; // WNetEnumResource 通常一次返回全部(受限于 buffer)
}

if (hEnum) WNetCloseEnum(hEnum);
return result;

}

注意:WNetOpenEnum 和 WNetEnumResource 在 winnetwk.h 中声明,链接时需加 -lNetapi32(MSVC 默认包含,MinGW 需显式链接)。另外,该 API 只返回当前用户会话的映射,不跨用户、不跨 session(如服务进程里调用将为空)。

为什么不用 PowerShell 或 net use 解析?

虽然 net use 命令输出看起来直观,但解析其文本输出极不稳定:不同系统语言(中文 Win10 输出含“状态”“本地”等字段)、不同版本格式微调(Win11 加了额外空格)、管道重定向时编码乱码(ANSI/UTF-8 混用),都会让正则匹配崩溃。PowerShell 的 Get-SmbMapping 更好些,但它依赖 SMB 协议栈,对 NFS 或 WebDAV 映射无效,且需要 .NET Framework / PowerShell 运行时,在嵌入式或精简系统中不可用。

原生 API 是唯一能覆盖所有 Windows 网络重定向器(包括第三方如 Samba Client、Dokan)的方案。只要系统显示“网络位置”里有该盘符,WNetEnumResource 就大概率能枚举出来——前提是调用者权限足够,且没被组策略禁用网络枚举(极少见,但生产环境要留意)。

真正的难点不在调用,而在容错:buffer 大小、多字节字符串截断、空指针访问、会话隔离。这些细节漏掉一个,程序在某台机器上就静默失败。

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

569

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

580

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

876

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

1986

2025.08.19

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1938

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3184

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6384

2023.10.24

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

20

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn