我来帮你搞定这个C++/WinRT下StorageFolder枚举文件的问题——之前我也踩过类似的链接错误坑，大多是项目配置没到位或者对异步返回类型理解错了。结合你提到的SDK版本（10.0.17666）和VS版本，下面给你一份能直接运行的代码示例，以及关键的避坑点：

完整代码示例（控制台程序版本） #

这个示例用应用安装目录作为枚举目标，你可以替换成自己需要的文件夹（比如KnownFolders里的文档库）：

#include "pch.h"
#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Foundation.h>
#include <iostream>

using namespace winrt;
using namespace Windows::Storage;
using namespace Windows::Foundation;

// 异步枚举文件的函数
IAsyncAction EnumerateFolderFilesAsync()
{
    // 获取应用安装目录作为测试文件夹
    StorageFolder targetFolder = Package::Current().InstalledLocation();

    // 重点：GetFilesAsync的返回类型是IAsyncOperation<IVectorView<StorageFile>>
    // 这是一个异步操作对象，必须用co_await获取最终的文件列表
    IVectorView<StorageFile> fileList = co_await targetFolder.GetFilesAsync();

    // 遍历输出文件信息
    for (const StorageFile& file : fileList)
    {
        std::wcout << L"文件名: " << file.Name().c_str() << std::endl;
        std::wcout << L"文件路径: " << file.Path().c_str() << std::endl;
        std::wcout << L"------------------------" << std::endl;
    }
}

int main()
{
    // 必须初始化WinRT线程公寓，否则所有WinRT API都会报错
    init_apartment();

    // 等待异步操作完成
    EnumerateFolderFilesAsync().get();

    return 0;
}

UWP应用版本（如果是UI场景） #

如果是在UWP的UI线程中使用，比如MainPage里，代码可以这样写（注意需要在Package.appxmanifest中声明对应文件夹的访问权限）：

#include "MainPage.h"
#include "winrt/Windows.Storage.h"
#include "winrt/Windows.UI.Xaml.Controls.h"

using namespace winrt;
using namespace Windows::UI::Xaml;
using namespace Windows::Storage;
using namespace Windows::UI::Xaml::Controls;

MainPage::MainPage()
{
    InitializeComponent();
    // 页面加载时执行枚举
    EnumerateLibraryFiles();
}

IAsyncAction MainPage::EnumerateLibraryFiles()
{
    // 获取文档库，需要在manifest中开启文档库访问权限
    StorageFolder docsFolder = KnownFolders::DocumentsLibrary();
    IVectorView<StorageFile> fileList = co_await docsFolder.GetFilesAsync();

    // 假设页面上有一个名为FileListView的ListView控件，用来显示文件名
    ListView listView = FileListView();
    for (const auto& file : fileList)
    {
        listView.Items().Append(file.Name());
    }
}

解决链接错误的关键要点 #

你遇到的链接错误，大概率是以下几个原因之一，对应解决方法：

• 头文件没引全：必须包含winrt/Windows.Storage.h和winrt/Windows.Foundation.h，这两个头文件包含了StorageFolder和异步操作的所有定义。
• 异步返回类型理解错了：GetFilesAsync是异步方法，不能直接用IVectorView接收返回值，它返回的是IAsyncOperation<IVectorView<StorageFile>>，必须通过co_await来提取最终的文件列表。
• 项目配置没到位：确保你的项目是C++/WinRT项目——如果是手动创建的项目，要在属性里开启C++/WinRT支持：
  • 项目属性 -> C/C++ -> General -> Additional Include Directories 添加$(WindowsSdkDir)Include\$(WindowsSDKVersion)\cppwinrt\winrt
  • 确保链接器设置里包含了必要的Windows Runtime库（VS的C++/WinRT模板会自动配置，手动项目需要自己检查）
• 线程公寓未初始化：在主线程必须调用init_apartment()，否则WinRT API无法正常工作，这也是常见的运行时/链接错误诱因。

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