FindNextFileW 函式 (fileapi.h)

語法

BOOL FindNextFileW(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAW lpFindFileData
);

[in] hFindFile

先前呼叫 FindFirstFile 或 FindFirstFileEx 函式所傳回的搜尋控制碼。

[out] lpFindFileData

WIN32_FIND_DATA 結構的指標，可接收所找到檔案或子目錄的相關資訊。

如果函式成功，傳回值為非零值， 而 lpFindFileData 參數包含下一個找到的檔案或目錄的相關資訊。

如果函式失敗，則傳回值為零， 且 lpFindFileData 的內容不確定。若要取得擴充的錯誤資訊，請呼叫 GetLastError 函式。

如果函式失敗，因為找不到更多相符的檔案， GetLastError 函式會傳回 ERROR_NO_MORE_FILES。

此函式會使用相同的搜尋篩選準則，用來建立在 hFindFile 參數中傳遞的搜尋控制碼。如需詳細資訊，請參閱 FindFirstFile 和 FindFirstFileEx。

不保證搜尋傳回檔案的順序，例如字母順序，而且相依于檔案系統。如果必須排序資料，應用程式必須在取得所有結果之後執行排序。

注意在極少數的情況下或大量載入的系統上，在呼叫此函式時，NTFS 檔案系統上的檔案屬性資訊可能不是最新的。若要確保取得目前的 NTFS 檔案系統檔案屬性，請呼叫 GetFileInformationByHandle 函式。

此函式傳回檔案名的順序取決於檔案系統類型。使用 NTFS 檔案系統和 CDFS 檔案系統時，名稱通常會依字母順序傳回。使用 FAT 檔案系統時，通常會依檔案寫入磁片的順序傳回名稱，其順序可能不是字母順序。不過，如先前所述，不保證這些行為。

如果路徑指向符號連結，則WIN32_FIND_DATA 緩衝區包含符號連結的相關資訊，而不是目標。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

如果有系結至檔案列舉控制碼的交易，則傳回的檔案受限於交易隔離規則。

如需範例，請參閱列出目錄中的檔案。

注意

fileapi.h 標頭會將 FindNextFile 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。


最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	fileapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll