Fungsi FindFirstFileNameW (fileapi.h)
Membuat enumerasi semua tautan keras ke file yang ditentukan. Fungsi FindFirstFileNameW mengembalikan handel ke enumerasi yang dapat digunakan pada panggilan berikutnya ke fungsi FindNextFileNameW .
Untuk melakukan operasi ini sebagai operasi yang ditransaksikan, gunakan fungsi FindFirstFileNameTransactedW .
Sintaks
HANDLE FindFirstFileNameW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName
);
Parameter
[in] lpFileName
Nama file.
[in] dwFlags
Dipesan; tentukan nol (0).
[in, out] StringLength
Ukuran buffer yang diacu oleh parameter LinkName , dalam karakter. Jika panggilan ini gagal dan kesalahan yang dikembalikan dari fungsi GetLastErrorERROR_MORE_DATA (234), nilai yang dikembalikan oleh parameter ini adalah ukuran yang ditujukan buffer oleh LinkName harus berisi semua data.
[in, out] LinkName
Penunjuk ke buffer untuk menyimpan nama tautan pertama yang ditemukan untuk lpFileName.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah handel pencarian yang dapat digunakan dengan fungsi FindNextFileNameW atau ditutup dengan fungsi FindClose .
Jika fungsi gagal, nilai yang dikembalikan adalah INVALID_HANDLE_VALUE (0xffffffff). Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .
Keterangan
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
Teknologi | Didukung |
---|---|
Protokol Server Message Block (SMB) 3.0 | Ya |
SMB 3.0 Transparent Failover (TFO) | Tidak |
SMB 3.0 dengan Berbagi File Peluasan Skala (SO) | Tidak |
Sistem File Volume Bersama Kluster (CsvFS) | Ya |
Sistem File Tangguh (ReFS) | Ya |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | fileapi.h (termasuk Windows.h, WinBase.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
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