共用方式為

FindFirstFileExFromAppW 函式 (fileapifromapp.h)

  • 發行項

使用符合指定之檔案或屬性的名稱和屬性，搜尋目錄。 此函式的行為與 FindFirstFileEx 相同，不同之處在於此函式遵守 通用 Windows 平台 應用程式安全性模型。

語法

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

參數

lpFileName

目錄或路徑，以及檔名。 檔名可以包含通配符，例如星號 (*) 或問號 (？) 。

此參數不應為 NULL、無效的字串 (例如空字串或遺漏終止 Null 字元的字串) ，或結尾為尾端反斜杠 (\) 。

如果字串以通配符、句號或目錄名稱結尾，則用戶必須能夠存取路徑上的根目錄和所有子目錄。

如需退出退出 MAX_PATH 限制而不加上 “\\？\” 的詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節以取得詳細數據。

fInfoLevelId

傳回數據的資訊層級。

此參數是其中一個 FINDEX_INFO_LEVELS 列舉值。

lpFindFileData

接收檔案數據的緩衝區指標。

指標類型取決於 fInfoLevelId 參數中指定的資訊層級。

fSearchOp

要執行的篩選類型，與通配符比對不同。

此參數是其中一個 FINDEX_SEARCH_OPS 列舉值。

lpSearchFilter

如果指定的 fSearchOp 需要結構化搜尋資訊，則為搜尋準則的指標。

目前，不支援的 fSearchOp 值都不需要延伸搜尋資訊。 因此，這個指標必須是 NULL。

dwAdditionalFlags

指定控制搜尋的其他旗標。

值 意義
FIND_FIRST_EX_CASE_SENSITIVE 1

搜尋會區分大小寫。
FIND_FIRST_EX_LARGE_FETCH 2

針對目錄查詢使用較大的緩衝區，這會增加尋找作業的效能。
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4

將結果限製為實際位於磁碟上的檔案。 只有在檔案虛擬化篩選存在時，此旗標才相關。

傳回值

如果函式成功，則傳回值是搜尋句柄，用於後續呼叫 FindNextFile 或 FindClose， 而 lpFindFileData 參數包含找到的第一個檔案或目錄的相關信息。

如果函式失敗或無法從 lpFileName 參數中的搜尋字串找出檔案，傳回值 會INVALID_HANDLE_VALUE 且 lpFindFileData 的內容不確定。 若要取得擴充的錯誤資訊，請呼叫 GetLastError 函式。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1803)
標頭 fileapifromapp.h