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 |