Fungsi EnumDirTree (dbghelp.h)
Menghitung semua kemunculan file yang ditentukan di pohon direktori yang ditentukan.
Sintaks
BOOL IMAGEAPI EnumDirTree(
[in, optional] HANDLE hProcess,
[in] PCSTR RootPath,
[in] PCSTR InputPathName,
[out, optional] PSTR OutputPathBuffer,
[in, optional] PENUMDIRTREE_CALLBACK cb,
[in, optional] PVOID data
);
Parameter
[in, optional] hProcess
Handel ke proses. Handel ini sebelumnya harus diteruskan ke fungsi SymInitialize .
[in] RootPath
Jalur tempat fungsi harus mulai mencari file.
[in] InputPathName
Nama file yang akan ditemukan. Anda dapat menentukan jalur parsial.
[out, optional] OutputPathBuffer
Penunjuk ke buffer yang menerima jalur lengkap file. Jika fungsi gagal atau tidak menemukan file yang cocok, buffer ini masih akan berisi jalur lengkap terakhir yang ditemukan.
Parameter ini bersifat opsional dan dapat berupa NULL.
[in, optional] cb
Fungsi panggilan balik yang ditentukan aplikasi, atau NULL. Untuk informasi selengkapnya, lihat EnumDirTreeProc.
[in, optional] data
Data yang ditentukan pengguna atau NULL. Nilai ini diteruskan ke fungsi panggilan balik.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
Pencarian dapat dibatalkan jika Anda mendaftarkan fungsi panggilan balik SymRegisterCallbackProc64 . Untuk setiap operasi file, EnumDirTree memanggil fungsi panggilan balik ini dengan CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Jika fungsi panggilan balik mengembalikan TRUE, EnumDirTree membatalkan pencarian.
Semua fungsi DbgHelp, seperti ini, adalah utas tunggal. Oleh karena itu, panggilan dari lebih dari satu utas ke fungsi ini kemungkinan akan mengakibatkan perilaku tak terduga atau kerusakan memori. Untuk menghindari hal ini, Anda harus menyinkronkan semua panggilan bersamaan dari lebih dari satu utas ke fungsi ini.
Untuk memanggil versi Unicode dari fungsi ini, tentukan DBGHELP_TRANSLATE_TCHAR.
Persyaratan
Target Platform | Windows |
Header | dbghelp.h |
Pustaka | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribusi | DbgHelp.dll 6.0 atau yang lebih baru |