C++中::SHCreateDirectoryEx函数使用方法

 更新时间:2025年03月24日 10:53:15   作者:SunkingYang  
::SHCreateDirectoryEx用于创建多级目录,类似于mkdir -p命令,本文主要介绍了C++中::SHCreateDirectoryEx函数使用方法,具有一定的参考价值,感兴趣的可以了解一下

在 C++ 中, ::SHCreateDirectoryEx 是 Windows Shell API 提供的函数,用于创建多级目录(类似于 mkdir -p 命令)。与标准库的 CreateDirectory 不同,它可以自动创建路径中缺失的中间目录。以下是详细使用方法及示例:

1. 函数原型与依赖项

#include <Windows.h>
#include <Shlobj.h>  // 包含头文件
#pragma comment(lib, "Shell32.lib")  // 链接 Shell32 库

int SHCreateDirectoryEx(
  _In_opt_ HWND                hwnd,         // 父窗口句柄(可设为 NULL)
  _In_     LPCTSTR             pszPath,      // 要创建的目录路径
  _In_opt_ const SECURITY_ATTRIBUTES *psa    // 安全属性(通常为 NULL)
);

返回值

  • 0ERROR_SUCCESS):创建成功。
  • 非零值:错误代码(可通过 GetLastError() 获取详细错误信息)。

2. 基本使用示例

示例 1:创建单层目录

#include <Windows.h>
#include <Shlobj.h>
#include <iostream>

int main() {
    LPCWSTR path = L"C:\\MyFolder";  // 宽字符路径(Unicode)

    int result = ::SHCreateDirectoryEx(
        NULL,        // 无父窗口
        path,        // 目录路径
        NULL         // 默认安全属性
    );

    if (result == ERROR_SUCCESS) {
        std::wcout << L"目录创建成功: " << path << std::endl;
    } else {
        std::wcerr << L"错误代码: " << result << std::endl;
    }

    return 0;
}

示例 2:创建多级目录

LPCWSTR path = L"C:\\Parent\\Child\\Grandchild";  // 自动创建中间缺失的目录
int result = ::SHCreateDirectoryEx(NULL, path, NULL);

3. 关键注意事项

(1) Unicode 与多字节字符集

推荐使用 Unicode 版本:Windows API 默认优先使用宽字符(WCHAR/LPCWSTR)。

若使用多字节字符集(char),需显式转换路径:

LPCSTR pathA = "C:\\MyFolder";
WCHAR pathW[MAX_PATH];
MultiByteToWideChar(CP_ACP, 0, pathA, -1, pathW, MAX_PATH);
::SHCreateDirectoryEx(NULL, pathW, NULL);

(2) 路径格式

使用 双反斜杠 \\ 或 正斜杠 / 作为分隔符:

LPCWSTR path1 = L"C:/MyFolder/Subdir";  // 正斜杠
LPCWSTR path2 = L"C:\\MyFolder\\Subdir"; // 双反斜杠

(3) 错误处理

通过返回值判断是否成功,结合 GetLastError() 获取详细信息:

if (result != ERROR_SUCCESS) {
    DWORD error = ::GetLastError();
    LPWSTR errorMsg = nullptr;
    ::FormatMessage(
        FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
        NULL,
        error,
        0,
        (LPWSTR)&errorMsg,
        0,
        NULL
    );
    std::wcerr << L"错误: " << errorMsg << std::endl;
    ::LocalFree(errorMsg);
}

4. 常见问题与解决方案

问题 1:路径权限不足

  • 表现:返回错误代码 5ERROR_ACCESS_DENIED)。
  • 解决
    • 以管理员权限运行程序(右键 → 以管理员身份运行)。
    • 修改目标目录权限(右键目录 → 属性 → 安全 → 编辑权限)。

问题 2:路径无效或包含非法字符

  • 表现:返回错误代码 123ERROR_INVALID_NAME)。
  • 解决:检查路径是否包含 <>:"|?* 等非法字符。

问题 3:磁盘空间不足

  • 表现:返回错误代码 112ERROR_DISK_FULL)。
  • 解决:清理磁盘或选择其他存储位置。

5. 替代方案

(1) 使用标准库 <filesystem>(C++17 及以上)

#include <filesystem>
namespace fs = std::filesystem;

bool createDirectory(const std::wstring& path) {
    try {
        return fs::create_directories(path);
    } catch (const fs::filesystem_error& e) {
        std::wcerr << L"错误: " << e.what() << std::endl;
        return false;
    }
}

(2) 使用 Boost 文件系统库

#include <boost/filesystem.hpp>
namespace fs = boost::filesystem;

bool createDirectory(const std::string& path) {
    try {
        return fs::create_directories(path);
    } catch (const fs::filesystem_error& e) {
        std::cerr << "错误: " << e.what() << std::endl;
        return false;
    }
}

总结

  • ::SHCreateDirectoryEx 是 Windows 平台下创建多级目录的高效工具,适合需要兼容旧版系统或直接使用 Shell API 的场景。
  • 使用时需注意 路径格式字符编码 及 错误处理
  • 对于新项目,优先考虑 C++17 的 <filesystem> 或 Boost 库,代码更简洁且跨平台。

到此这篇关于C++中::SHCreateDirectoryEx函数使用方法的文章就介绍到这了,更多相关C++ ::SHCreateDirectoryEx内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家! 

相关文章

  • C++实现简单的ls命令及其原理

    C++实现简单的ls命令及其原理

    这篇文章主要介绍了C++实现简单的ls命令及其原理,C++实现ls命令可通过调用系统函数实现读取目录中的文件名和属性,再通过标准输出进行显示,需要的朋友可以参考下
    2023-05-05
  • 基于C语言实现三子棋游戏的示例代码

    基于C语言实现三子棋游戏的示例代码

    这篇文章主要为大家详细介绍了如何利用C语言数组实现简单的三子棋游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-07-07
  • C语言数据的存储超详细讲解下篇浮点型在内存中的存取

    C语言数据的存储超详细讲解下篇浮点型在内存中的存取

    使用编程语言进行编程时,需要用到各种变量来存储各种信息。变量保留的是它所存储的值的内存位置。这意味着,当您创建一个变量时,就会在内存中保留一些空间。您可能需要存储各种数据类型的信息,操作系统会根据变量的数据类型,来分配内存和决定在保留内存中存储什么
    2022-04-04
  • C语言控制台打砖块小游戏

    C语言控制台打砖块小游戏

    这篇文章主要为大家详细介绍了C语言控制台打砖块小游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-05-05
  • C语言多维数组数据结构的实现详解

    C语言多维数组数据结构的实现详解

    对于数组想必大家都不陌生首先得要知道的是对于数组元素在内存存储是连续性的,下面这篇文章主要给大家介绍了关于C语言多维数组数据结构的相关资料,需要的朋友可以参考下
    2021-12-12
  • 用c++实现x的y次幂的代码

    用c++实现x的y次幂的代码

    以下实例是对使用c++实现x的y次幂的解决方法进行了介绍。需要的朋友参考下
    2013-05-05
  • 解析C++中四种强制类型转换的区别详解

    解析C++中四种强制类型转换的区别详解

    本篇文章是对C++中四种强制类型转换的区别进行了详细的分析介绍,需要的朋友参考下
    2013-05-05
  • C语言实现手机电话簿管理系统

    C语言实现手机电话簿管理系统

    这篇文章主要为大家详细介绍了C语言实现手机电话簿管理系统,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-06-06
  • 基于C语言航班信息查询与检索

    基于C语言航班信息查询与检索

    这篇文章主要为大家详细介绍了基于C语言航班信息查询与检索,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-01-01
  • C++模拟实现vector示例代码图文讲解

    C++模拟实现vector示例代码图文讲解

    这篇文章主要介绍了C++容器Vector的模拟实现,Vector是一个能够存放任意类型的动态数组,有点类似数组,是一个连续地址空间,下文更多详细内容的介绍,需要的小伙伴可以参考一下
    2023-02-02

最新评论