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

Lihat juga

Fungsi DbgHelp

EnumDirTreeProc