FindNextFileNameW 函数 (fileapi.h)
使用成功的 FindFirstFileNameW 函数调用返回的句柄继续枚举指向文件的硬链接。
语法
BOOL FindNextFileNameW(
[in] HANDLE hFindStream,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName
);
参数
[in] hFindStream
成功调用 FindFirstFileNameW 返回的枚举句柄。
[in, out] StringLength
LinkName 参数的大小(以字符为单位)。 如果此调用失败且 错误ERROR_MORE_DATA,则此参数返回的值是 LinkName 必须包含所有数据的大小。
[in, out] LinkName
指向缓冲区的指针,用于存储为 lpFileName 找到的第一个链接名称。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零 (0)。 要获得更多的错误信息,请调用 GetLastError。
如果找不到匹配的文件, GetLastError 函数将返回 ERROR_HANDLE_EOF。
备注
如果函数返回 TRUE,则有更多硬链接要枚举。
在 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 |