如何在遵循RAII原则的C++代码中正确使用WINAPI的HANDLE对象？

先纠正你代码里的几个明显问题：

• 绝对不能调用delete handle;：HANDLE是系统内核对象的句柄，不是用new在堆上分配的内存，delete完全不适用，正确的关闭方式是FindClose。
• 缺少错误处理：如果FindFirstFileW失败（返回INVALID_HANDLE_VALUE），后续的FindNextFile和FindClose都会触发未定义行为。
• 当前代码没有自动句柄管理：如果遍历过程中提前返回或者抛出异常，FindClose不会被调用，句柄会泄漏。

下面是两种符合RAII原则的HANDLE管理方案，都会自动在对象生命周期结束时关闭句柄：

方案一：自定义专属RAII类 #

专门为文件遍历句柄写一个RAII类，语义清晰，适合频繁使用的场景：

#include <windows.h>
#include <utility> // 用于移动语义

class FindFileHandle {
public:
    // 构造函数，默认初始化无效句柄
    explicit FindFileHandle(HANDLE h = INVALID_HANDLE_VALUE) : m_handle(h) {}

    // 析构函数自动关闭句柄
    ~FindFileHandle() {
        if (m_handle != INVALID_HANDLE_VALUE) {
            FindClose(m_handle);
        }
    }

    // 禁止拷贝：一个句柄不能被多个对象同时管理
    FindFileHandle(const FindFileHandle&) = delete;
    FindFileHandle& operator=(const FindFileHandle&) = delete;

    // 支持移动：转移句柄的所有权
    FindFileHandle(FindFileHandle&& other) noexcept : m_handle(other.m_handle) {
        other.m_handle = INVALID_HANDLE_VALUE;
    }

    FindFileHandle& operator=(FindFileHandle&& other) noexcept {
        if (this != &other) {
            // 先关闭当前句柄
            if (m_handle != INVALID_HANDLE_VALUE) {
                FindClose(m_handle);
            }
            // 转移所有权
            m_handle = other.m_handle;
            other.m_handle = INVALID_HANDLE_VALUE;
        }
        return *this;
    }

    // 获取原始句柄
    HANDLE get() const { return m_handle; }
    // 判断句柄是否有效
    bool isValid() const { return m_handle != INVALID_HANDLE_VALUE; }

private:
    HANDLE m_handle;
};

用这个类修改你的卸载函数，同时补充错误处理：

#include <string>
#include <windows.h>

bool Uninstall(const std::wstring& folder, bool removeDir = false)
{
    WIN32_FIND_DATA ffd; // 直接栈上分配，比unique_ptr更高效
    const std::wstring searchPath = folder + L"\\*";

    // RAII句柄自动管理，构造时直接传入FindFirstFile的返回值
    FindFileHandle hFind(FindFirstFileW(searchPath.c_str(), &ffd));
    if (!hFind.isValid()) {
        // 处理错误：比如目录不存在，返回失败
        return false;
    }

    do {
        // 跳过当前目录和父目录
        if (wcscmp(ffd.cFileName, L".") != 0 && wcscmp(ffd.cFileName, L"..") != 0) {
            const std::wstring fullPath = folder + L"\\" + ffd.cFileName;
            const DWORD fileAttrs = GetFileAttributesW(fullPath.c_str());

            if (fileAttrs != INVALID_FILE_ATTRIBUTES && (fileAttrs & FILE_ATTRIBUTE_DIRECTORY)) {
                // 递归卸载子目录
                if (!Uninstall(fullPath, false)) {
                    return false;
                }
            } else {
                // 删除文件
                if (!DeleteFileW(fullPath.c_str())) {
                    return false;
                }
            }
        }
    } while (FindNextFileW(hFind.get(), &ffd));

    // 检查遍历结束的原因：是真的没有更多文件，还是出错了
    const DWORD lastErr = GetLastError();
    if (lastErr != ERROR_NO_MORE_FILES) {
        return false;
    }

    // 删除当前目录（如果需要）
    if (!removeDir) {
        if (!RemoveDirectoryW(folder.c_str())) {
            return false;
        }
    }

    return true;
}

方案二：用std::unique_ptr配合自定义删除器 #

如果不想写新类，可以直接用标准库的unique_ptr，给它指定一个专门的删除器：

#include <memory>
#include <windows.h>

// 定义删除器：负责关闭FindFile句柄
struct FindFileDeleter {
    void operator()(HANDLE h) const {
        if (h != INVALID_HANDLE_VALUE) {
            FindClose(h);
        }
    }
};

// 定义专属的unique_ptr类型
using FindFilePtr = std::unique_ptr<std::remove_pointer_t<HANDLE>, FindFileDeleter>;

使用方式和自定义类类似，替换掉原来的HANDLE声明即可：

FindFilePtr hFind(FindFirstFileW(searchPath.c_str(), &ffd));
// 获取原始句柄用hFind.get()，和unique_ptr用法一致

额外的最佳实践 #

• 始终检查WINAPI返回值：WINAPI调用很容易失败，比如权限不足、文件被占用，必须处理这些错误。
• 避免不必要的堆分配：WIN32_FIND_DATA是固定大小的结构体，直接栈上分配比用unique_ptr更高效。
• 区分句柄类型：不同的WINAPI句柄需要不同的关闭函数（比如文件句柄用CloseHandle，注册表句柄用RegCloseKey），所以RAII类/删除器要对应专属的句柄类型，不要混用。

内容的提问来源于stack exchange，提问作者Ohad Porat