FindFirstFileNameW 函数 (fileapi.h)
创建指向指定文件的所有硬链接的枚举。 FindFirstFileNameW 函数返回枚举的句柄，该句柄可用于后续调用 FindNextFileNameW 函数。
若要以事务处理操作的形式执行此操作，请使用 FindFirstFileNameTransactedW 函数。
语法
HANDLE FindFirstFileNameW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName
);
参数
[in] lpFileName
文件的名称。
提示从 Windows 10 版本 1607 开始，可以选择删除MAX_PATH限制，而无需在前面添加“\\？\”。 有关详细信息，请参阅 命名文件、路径和命名空间 的“最大路径长度限制”部分。
[in] dwFlags
保留;指定零 (0) 。
[in, out] StringLength
LinkName 参数指向的缓冲区的大小（以字符为单位）。 如果此调用失败，并且从 GetLastError 函数返回的错误 ERROR_MORE_DATA (234) ，则此参数返回的值是 LinkName 指向的缓冲区必须包含所有数据的大小。
[in, out] LinkName
指向缓冲区的指针，用于存储为 lpFileName 找到的第一个链接名称。
返回值
如果函数成功，则返回值是可与 FindNextFileNameW 函数一起使用或使用 FindClose 函数关闭的搜索句柄。
如果函数失败，则返回值 INVALID_HANDLE_VALUE (0xffffffff) 。 若要获得更多的错误信息，请调用 GetLastError 函数。
注解
在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。
| 技术 | 支持 |
|---|---|
| 服务器消息块 (SMB) 3.0 协议 | 是 |
| SMB 3.0 透明故障转移 (TFO) | 否 |
| 具有横向扩展文件共享的 SMB 3.0 (SO) | 否 |
| 群集共享卷文件系统 (CSV) | 是 |
| 弹性文件系统 (ReFS) | 是 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | fileapi.h (包括 Windows.h、WinBase.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |