C++中::SHCreateDirectoryEx函数使用方法-牛翰网

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）
);

返回值：

0（ERROR_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：路径权限不足

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

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

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

问题 3：磁盘空间不足

表现：返回错误代码 112（ERROR_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;
    }
}