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.

Tips Dimulai dengan Windows 10, versi 1607, Anda dapat memilih untuk menghapus batasan MAX_PATH tanpa menambahkan sebelumnya "\\?\". Lihat bagian "Batasan Panjang Jalur Maksimum" di Penamaan File, Jalur, dan Namespace untuk detailnya.

 

[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

Fungsi Manajemen File

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW