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.cppcns.com/ruanjian/c/705302.html
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/1153915

相关文章

C++中detach的作用、使用场景及注意事项

《C++中detach的作用、使用场景及注意事项》关于C++中的detach,它主要涉及多线程编程中的线程管理,理解detach的作用、使用场景以及注意事项,对于写出高效、安全的多线程程序至关重要,下... 目录一、什么是join()?它的作用是什么?类比一下:二、join()的作用总结三、join()怎么

mybatis中resultMap的association及collectio的使用详解

《mybatis中resultMap的association及collectio的使用详解》MyBatis的resultMap定义数据库结果到Java对象的映射规则,包含id、type等属性,子元素需... 目录1.reusltmap的说明2.association的使用3.collection的使用4.总

Spring Boot配置和使用两个数据源的实现步骤

《SpringBoot配置和使用两个数据源的实现步骤》本文详解SpringBoot配置双数据源方法,包含配置文件设置、Bean创建、事务管理器配置及@Qualifier注解使用,强调主数据源标记、代... 目录Spring Boot配置和使用两个数据源技术背景实现步骤1. 配置数据源信息2. 创建数据源Be

Java中使用 @Builder 注解的简单示例

《Java中使用@Builder注解的简单示例》@Builder简化构建但存在复杂性,需配合其他注解,导致可变性、抽象类型处理难题,链式编程非最佳实践,适合长期对象,避免与@Data混用,改用@G... 目录一、案例二、不足之处大多数同学使用 @Builder 无非就是为了链式编程,然而 @Builder

在MySQL中实现冷热数据分离的方法及使用场景底层原理解析

《在MySQL中实现冷热数据分离的方法及使用场景底层原理解析》MySQL冷热数据分离通过分表/分区策略、数据归档和索引优化,将频繁访问的热数据与冷数据分开存储,提升查询效率并降低存储成本,适用于高并发... 目录实现冷热数据分离1. 分表策略2. 使用分区表3. 数据归档与迁移在mysql中实现冷热数据分

Spring Boot从main方法到内嵌Tomcat的全过程(自动化流程)

《SpringBoot从main方法到内嵌Tomcat的全过程(自动化流程)》SpringBoot启动始于main方法,创建SpringApplication实例,初始化上下文,准备环境,刷新容器并... 目录1. 入口:main方法2. SpringApplication初始化2.1 构造阶段3. 运行阶

mybatis-plus QueryWrapper中or,and的使用及说明

《mybatis-plusQueryWrapper中or,and的使用及说明》使用MyBatisPlusQueryWrapper时,因同时添加角色权限固定条件和多字段模糊查询导致数据异常展示,排查发... 目录QueryWrapper中or,and使用列表中还要同时模糊查询多个字段经过排查这就导致只要whe

Olingo分析和实践之ODataImpl详细分析(重要方法详解)

《Olingo分析和实践之ODataImpl详细分析(重要方法详解)》ODataImpl.java是ApacheOlingoOData框架的核心工厂类,负责创建序列化器、反序列化器和处理器等组件,... 目录概述主要职责类结构与继承关系核心功能分析1. 序列化器管理2. 反序列化器管理3. 处理器管理重要方

Python错误AttributeError: 'NoneType' object has no attribute问题的彻底解决方法

《Python错误AttributeError:NoneTypeobjecthasnoattribute问题的彻底解决方法》在Python项目开发和调试过程中,经常会碰到这样一个异常信息... 目录问题背景与概述错误解读:AttributeError: 'NoneType' object has no at

Python使用openpyxl读取Excel的操作详解

《Python使用openpyxl读取Excel的操作详解》本文介绍了使用Python的openpyxl库进行Excel文件的创建、读写、数据操作、工作簿与工作表管理,包括创建工作簿、加载工作簿、操作... 目录1 概述1.1 图示1.2 安装第三方库2 工作簿 workbook2.1 创建:Workboo