Fungsi FindFirstFileExFromAppW (fileapifromapp.h)
Mencari direktori untuk file atau subdirektori dengan nama dan atribut yang cocok dengan yang ditentukan. Perilaku fungsi ini identik dengan FindFirstFileEx, kecuali bahwa fungsi ini mematuhi model keamanan aplikasi Platform Windows Universal.
Sintaks
WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
LPCWSTR lpFileName,
FINDEX_INFO_LEVELS fInfoLevelId,
LPVOID lpFindFileData,
FINDEX_SEARCH_OPS fSearchOp,
LPVOID lpSearchFilter,
DWORD dwAdditionalFlags
) noexcept;
Parameter
lpFileName
Direktori atau jalur, dan nama file. Nama file dapat menyertakan karakter kartubebas, misalnya, tanda bintang (*) atau tanda tanya (?).
Parameter ini tidak boleh NULL, string yang tidak valid (misalnya, string kosong atau string yang tidak memiliki karakter null yang mengakhiri), atau berakhir dengan garis miring terbalik berikutnya (\).
Jika string berakhir dengan kartubebas, titik, atau nama direktori, pengguna harus memiliki akses ke akar dan semua subdirektori di jalur.
Untuk informasi tentang menolak batasan MAX_PATH tanpa menambahkan "\\?\", lihat bagian "Batasan Panjang Jalur Maksimum" dari Penamaan File, Jalur, dan Namespace untuk detailnya.
fInfoLevelId
Tingkat informasi data yang dikembalikan.
Parameter ini adalah salah satu nilai enumerasi FINDEX_INFO_LEVELS .
lpFindFileData
Penunjuk ke buffer yang menerima data file.
Jenis penunjuk ditentukan oleh tingkat informasi yang ditentukan dalam parameter fInfoLevelId .
fSearchOp
Jenis pemfilteran untuk dilakukan yang berbeda dari pencocokan kartubebas.
Parameter ini adalah salah satu nilai enumerasi FINDEX_SEARCH_OPS .
lpSearchFilter
Penunjuk ke kriteria pencarian jika fSearchOp yang ditentukan memerlukan informasi pencarian terstruktur.
Saat ini, tidak ada nilai fSearchOp yang didukung yang memerlukan informasi pencarian yang diperluas. Oleh karena itu, pointer ini harus NULL.
dwAdditionalFlags
Menentukan bendera tambahan yang mengontrol pencarian.
Nilai | Makna |
---|---|
FIND_FIRST_EX_CASE_SENSITIVE 1 | Pencarian peka huruf besar/kecil. |
FIND_FIRST_EX_LARGE_FETCH 2 | Menggunakan buffer yang lebih besar untuk kueri direktori, yang dapat meningkatkan performa operasi temukan. |
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4 | Membatasi hasil ke file yang secara fisik berada di disk. Bendera ini hanya relevan ketika filter virtualisasi file ada. |
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah handel pencarian yang digunakan dalam panggilan berikutnya ke FindNextFile atau FindClose, dan parameter lpFindFileData berisi informasi tentang file atau direktori pertama yang ditemukan.
Jika fungsi gagal atau gagal menemukan file dari string pencarian dalam parameter lpFileName , nilai yang dikembalikan INVALID_HANDLE_VALUE dan konten lpFindFileData tidak ditentukan. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10, versi 1803 |
Header | fileapifromapp.h |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk