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

云宇吖_5290

云宇吖_5290

2026-04-04

288人浏览

原创

应使用 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,说明这个盘符虽然出现在网络资源列表里,但当前底层连接可能已失效或被其他机制接管,应过滤掉。

  • 常见误报: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;</byte></netdriveinfo></netdriveinfo></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 <p>}</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
														src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
													<p class="overflowclass">C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div></netresource>

注意: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++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

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

相关专题

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

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

2023.09.22

569

3

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

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

2024.03.01

1698

6

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

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

2023.10.17

580

4

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

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

2023.10.18

876

5

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

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

2025.08.19

1986

14

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

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

2023.08.03

1938

5

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

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

2023.09.04

3184

5

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

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

2023.10.24

6384

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6549

6

热门下载

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

精品课程

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

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

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

共0课时 | 0人学习