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 通訊協定	Yes
SMB 3.0 透明故障轉移 (TFO)	No
具有向外延展檔案共用的SMB 3.0 (SO)	No
叢集共用磁碟區文件系統 (CsvFS)	Yes
彈性檔案系統 (ReFS)	Yes

規格需求

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