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

2025-03-24 14:50

本文主要是介绍C++中::SHCreateDirectoryEx函数使用方法,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《C++中::SHCreateDirectoryEx函数使用方法》::SHCreateDirectoryEx用于创建多级目录,类似于mkdir-p命令,本文主要介绍了C++中::SHCreateDir...

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

1. 函数原型与依赖项

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

int SHCreateDirectoryEChina编程x(
  _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;
    }
}

总结

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

到此这篇关于C++中::SHCreateDirectoryEx函数使用方法的文章就介绍到这了,更多相关C++ ::SHCreateDirecChina编程toryEx内容请搜索编程China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持China编程(www.chinasem.cn)! 

这篇关于C++中::SHCreateDirectoryEx函数使用方法的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1153915

相关文章

C++中RAII资源获取即初始化

《C++中RAII资源获取即初始化》RAII通过构造/析构自动管理资源生命周期,确保安全释放,本文就来介绍一下C++中的RAII技术及其应用,具有一定的参考价值,感兴趣的可以了解一下... 目录一、核心原理与机制二、标准库中的RAII实现三、自定义RAII类设计原则四、常见应用场景1. 内存管理2. 文件操

C++中零拷贝的多种实现方式

《C++中零拷贝的多种实现方式》本文主要介绍了C++中零拷贝的实现示例,旨在在减少数据在内存中的不必要复制,从而提高程序性能、降低内存使用并减少CPU消耗,零拷贝技术通过多种方式实现,下面就来了解一下... 目录一、C++中零拷贝技术的核心概念二、std::string_view 简介三、std::stri

Python常用命令提示符使用方法详解

《Python常用命令提示符使用方法详解》在学习python的过程中,我们需要用到命令提示符(CMD)进行环境的配置,:本文主要介绍Python常用命令提示符使用方法的相关资料,文中通过代码介绍的... 目录一、python环境基础命令【Windows】1、检查Python是否安装2、 查看Python的安

C++高效内存池实现减少动态分配开销的解决方案

《C++高效内存池实现减少动态分配开销的解决方案》C++动态内存分配存在系统调用开销、碎片化和锁竞争等性能问题,内存池通过预分配、分块管理和缓存复用解决这些问题,下面就来了解一下... 目录一、C++内存分配的性能挑战二、内存池技术的核心原理三、主流内存池实现:TCMalloc与Jemalloc1. TCM

Python并行处理实战之如何使用ProcessPoolExecutor加速计算

《Python并行处理实战之如何使用ProcessPoolExecutor加速计算》Python提供了多种并行处理的方式,其中concurrent.futures模块的ProcessPoolExecu... 目录简介完整代码示例代码解释1. 导入必要的模块2. 定义处理函数3. 主函数4. 生成数字列表5.

Python中help()和dir()函数的使用

《Python中help()和dir()函数的使用》我们经常需要查看某个对象(如模块、类、函数等)的属性和方法,Python提供了两个内置函数help()和dir(),它们可以帮助我们快速了解代... 目录1. 引言2. help() 函数2.1 作用2.2 使用方法2.3 示例(1) 查看内置函数的帮助(

Linux脚本(shell)的使用方式

《Linux脚本(shell)的使用方式》:本文主要介绍Linux脚本(shell)的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录概述语法详解数学运算表达式Shell变量变量分类环境变量Shell内部变量自定义变量:定义、赋值自定义变量:引用、修改、删

Java使用HttpClient实现图片下载与本地保存功能

《Java使用HttpClient实现图片下载与本地保存功能》在当今数字化时代,网络资源的获取与处理已成为软件开发中的常见需求,其中,图片作为网络上最常见的资源之一,其下载与保存功能在许多应用场景中都... 目录引言一、Apache HttpClient简介二、技术栈与环境准备三、实现图片下载与保存功能1.

Python中使用uv创建环境及原理举例详解

《Python中使用uv创建环境及原理举例详解》uv是Astral团队开发的高性能Python工具,整合包管理、虚拟环境、Python版本控制等功能,:本文主要介绍Python中使用uv创建环境及... 目录一、uv工具简介核心特点:二、安装uv1. 通过pip安装2. 通过脚本安装验证安装:配置镜像源(可

C++ 函数 strftime 和时间格式示例详解

《C++函数strftime和时间格式示例详解》strftime是C/C++标准库中用于格式化日期和时间的函数,定义在ctime头文件中,它将tm结构体中的时间信息转换为指定格式的字符串,是处理... 目录C++ 函数 strftipythonme 详解一、函数原型二、功能描述三、格式字符串说明四、返回值五