如何使用 Windows API 列出目录中的文件？

Question

我有这段代码，它会显示包含目录本身而不是其内容的文件夹。我想显示它的内容。我不想使用 boost::filesystem。

我该如何解决这个问题？

代码：

#include <windows.h>
#include <iostream>

int main()
{
    WIN32_FIND_DATA data;
    HANDLE hFind = FindFirstFile("C:\\semester2", &data);      // DIRECTORY

    if ( hFind != INVALID_HANDLE_VALUE ) {
        do {
            std::cout << data.cFileName << std::endl;
        } while (FindNextFile(hFind, &data));
        FindClose(hFind);
    }
}

输出：

semester2

Answer 1

HANDLE hFind = FindFirstFile("C:\\semester2", &data);       // DIRECTORY

你得到了目录，因为那是你所要求的。如果您想要这些文件，请索取：

HANDLE hFind = FindFirstFile("C:\\semester2\\*", &data);  // FILES

（如果您愿意，您可以改用*.*，但显然这只适用于向后兼容性黑客，因此应该避免使用。请参阅 cmets 和 RbMm 的答案。）

Answer 2

Harrys 的回答实际上会在您想要的文件夹"C:\\semester2" 中生成具有扩展名的文件和文件夹。

例如，如果您有一个名为"C:\\semester2\\math.course" 的文件夹，上面的示例也可以找到它。此外，如果您有一个名为 "C:\\semester2\\math_scores" 的文件（请注意它没有扩展名），它将不会被找到。

考虑到上述情况，我建议以下解决方案：

HANDLE hFind = FindFirstFile("C:\\semester2\\*", &data); 

这将列出目录下的整个项目列表。 可以通过以下方式过滤目录：

if (data.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
{
// directory
}
else
{
// file
}

以下可用于参考：FileAttributes constants、FIND_DATA struct、FindFirstFile API

Answer 3

让我对"*.*" 与"*" 做一些笔记。这些申报者不相等。

我们的文件夹中可以存在 2 个不同的文件：somefile 和 somefile.。

如果我们使用低级 api ZwQueryDirectoryFile 和 "*.*" 作为搜索表达式（这是第 10 个参数 - FileName [in, optional]） - 我们只会得到 somefile.。但是如果我们使用"*"，我们会得到两个文件——somefile 和somefile.

如果我们尝试FindFirstFile("C:\\semester2\\*.*", &data);，我们可以注意到somefile 和somefile. 两个文件都被返回。所以这里"*.*" 和"*" 的效果是一样的——用法上没有区别。

为什么会这样？因为在 kernelbase (kernel32) 中的 FindFirstFileEx 内部会特别检查 "*.*" 掩码，如果它为真 - 替换为 "" （与 "*" 具有相同效果的空名称）。

我认为这样做是为了解决当用户传递 "*.*" 而不是正确的 "*" 时的一个非常常见的错误，以及与旧代码的向后兼容性。

. 和 .. 实际上并不是目录的一部分，因为它存储在 磁盘，但由 Win32 API 添加。

这不是真的。

• 对于FAT 风格的文件系统，这实际上是作为第2 个条目存储在FAT 目录中的。
• 在NTFS 中没有这样的条目，但是NTFS.sys 人为地添加了这两个条目，如果它们在掩码中。

所以这不是在 Win32 API 级别，而是在内核 - 驱动程序级别。

总而言之，"*.*" 可以在 Win32 API 上正常工作，现在最低限度 - 但正确和干净的方法是在此处使用 "*"。
"*.*" 将与 ZwQueryDirectoryFile api 错误。

Answer 4

这是一个示例实现：

#include <iostream>
#include <vector>
#include <string>
#include <Windows.h>

std::vector<std::string>
list_directory(
    const std::string &directory)
{
    WIN32_FIND_DATAA findData;
    HANDLE hFind = INVALID_HANDLE_VALUE;
    std::string full_path = directory + "\\*";
    std::vector<std::string> dir_list;

    hFind = FindFirstFileA(full_path.c_str(), &findData);

    if (hFind == INVALID_HANDLE_VALUE)
        throw std::runtime_error("Invalid handle value! Please check your path...");

    while (FindNextFileA(hFind, &findData) != 0)
    {
        dir_list.push_back(std::string(findData.cFileName));
    }

    FindClose(hFind);

    return dir_list;
}

注意：如果您使用 C++ 11，最好使用 boost::filesystem 或 std::filesystem 如果您使用 C++ 17。 此外，输入路径必须像 C:\path 而不是 C:\path\ 否则这将不起作用！！