FindFirstFileNameW 函数 (fileapi.h)

创建指向指定文件的所有硬链接的枚举。 FindFirstFileNameW 函数返回枚举的句柄,该句柄可用于对 FindNextFileNameW 函数的后续调用。

若要将此操作作为事务处理操作执行,请使用 FindFirstFileNameTransactedW 函数。

语法

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

参数

[in] lpFileName

文件的名称。

提示从版本 1607 Windows 10开始,可以选择删除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)
群集共享卷文件系统 (CsvFS)
弹性文件系统 (ReFS)

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 fileapi.h (包括 Windows.h、WinBase.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

文件管理功能

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW