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