Windows开发：映射网络共享目录(磁盘映射)

简介

整理磁盘映射相关命令行和代码实现。

命令行映射

命令行映射：

使用net use命令映射，其命令帮助如下：

C:\Users\Administrator>net use /help
此命令的语法是:

NET USE
[devicename | *] [\\computername\sharename[\volume] [password | *]]
        [/USER:[domainname\]username]
        [/USER:[dotted domain name\]username]
        [/USER:[username@dotted domain name]
        [/SMARTCARD]
        [/SAVECRED]
        [/REQUIREINTEGRITY]
        [/REQUIREPRIVACY]
        [/WRITETHROUGH]
        [[/DELETE] | [/PERSISTENT:{YES | NO}]]

NET USE {devicename | *} [password | *] /HOME

NET USE [/PERSISTENT:{YES | NO}]

NET USE 将计算机连接到共享资源
或将计算机与共享资源断开连接。使用时如果没有选项，它会列出
计算机的连接。

devicename       分配一个名称以连接到资源，或指定
                 要断开连接的设备。有两种
                 设备名称: 磁盘驱动器(D: 至 Z:)和打印机
                 (LPT1: 至 LPT3:)。键入星号而不是
                 特定设备名称以分配下一个可用
                 设备名称。
\\computername   为控制共享资源的计算机
                 的名称。如果计算机名包含空白字符，
                 则用引号(" ")将双反斜杠(\\)和计算机名
                 括起来。计算机名的长度可以为
                 1 至 15 个字符。
\sharename       为共享资源的网络名称。
\volume          指定服务器上的 NetWare 卷。必须已安装并正在运行
                 Netware 客户端服务(Windows Workstations)
                 或 Netware 网关服务(Windows Server)
                 才能连接到 NetWare 服务器。
password         为访问共享资源所需的密码。
*                产生密码提示。在密码提示处
                 键入密码时不显示密码。
/USER            指定进行连接的另一个
                 用户名。
domainname       指定其他域。如果忽略域，
                 则使用当前登录的域。
username         指定登录所使用的用户名。
/SMARTCARD       指定连接将使用智能卡上
                 的凭据。
/SAVECRED        指定要保存用户名和密码。
                 该开关将被忽略，除非命令提示输入用户名
                 和密码。
/HOME            将用户连接到他们的主目录。
/DELETE          取消网络连接并
                 从持续连接列表中删除该连接。
/REQUIREINTEGRITY
                 需要签名的共享连接。如果提供程序
                 不支持签名连接，则操作将失败。
/REQUIREPRIVACY  需要加密的共享连接。如果提供程序
                 不支持加密连接，则操作将失败。

/PERSISTENT      控制持续网络连接的使用。
                 默认为上次使用的设置。
YES              进行连接时将它们保存，并在下次
                 登录时将它们恢复。
NO               不保存正在进行的连接或随后的
                 连接；下次登录时将恢复
                 现有连接。使用 /DELETE 开关删除
                 持续连接。

NET HELP 命令 | MORE 显示帮助，一次显示一屏。

常见命令使用：

# 查看映射信息
net use

# x:  指定挂在的盘符
# \\10.121.3.11\public  指定的网络路径
# password 密码
# administrator 用户名
net use x: \\10.125.17.32\share "123456" /user:"administrator" /Persistent:Yes

# 删除关在的盘符
net use z: /delete

映射失败，错误码1219，提示如下。在资源管理器中关闭对应的文件浏览或者卸载之前的映射。

发生系统错误 1219。

不允许一个用户使用一个以上用户名与服务器或共享资源的多重连接。中断与此服务器或共享资源的所有连接，然后再试一次。

代码映射

WNetAddConnection2A映射，WNetCancelConnection2A取消映射。

#include <windows.h>
#include <winnetwk.h>

#pragma comment(lib, "mpr.lib")

int mountNetRes(const std::string &localDiskName, const std::string &remoteResUrl, const std::string &userName, const std::string &password)
{
    NETRESOURCEA nr;
    nr.dwType = RESOURCETYPE_ANY;
    nr.lpLocalName = (char*)localDiskName.c_str();
    nr.lpRemoteName = (char*) remoteResUrl.c_str();
    nr.lpProvider = nullptr;

    auto ret = WNetAddConnection2A(&nr, (char*)password.c_str(), (char*)userName.c_str(), CONNECT_UPDATE_PROFILE);
    if (ret == 0)
    {
        return 0;
    }
    else
    {
        return GetLastError();
    }
}

// name:本地的磁盘名或者远程的资源路径都可以
int unmountNetRes(const std::string &name)
{
    auto ret = WNetCancelConnection2A((char*)name.c_str(), CONNECT_UPDATE_PROFILE, TRUE);
    if (ret == 0)
    {
        return 0;
    }
    else
    {
        return GetLastError();
    }
}

int main()
{

    auto ret = unmountNetRes("X:");
    std::cout << "code:" << ret << std::endl;

    ret = mountNetRes("X:", "\\\\10.125.17.32\\share", "administrator", "123456");
    std::cout << ret << std::endl;
    
    return 0
}