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) 否
叢集共用磁片區檔案系統 (CsvFS) 是
彈性檔案系統 (ReFS) 是

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 fileapi.h (包括 Windows.h、WinBase.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

FindClose

FindFirstFileNameW