Fungsi SearchTreeForFile (dbghelp.h)

Mencari pohon direktori untuk file tertentu.

Sintaks

BOOL IMAGEAPI SearchTreeForFile(
  [in]  PCSTR RootPath,
  [in]  PCSTR InputPathName,
  [out] PSTR  OutputPathBuffer
);

Parameter

[in] RootPath

Jalur tempat fungsi harus mulai mencari file.

[in] InputPathName

File yang akan dicari fungsinya. Anda dapat menggunakan jalur parsial.

[out] OutputPathBuffer

Penunjuk ke buffer yang menerima jalur lengkap ke file yang ditemukan. String ini tidak dimodifikasi jika nilai yang dikembalikan adalah FALSE.

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

Fungsi ini mencari file yang ditentukan oleh parameter InputPathName yang dimulai pada jalur yang ditentukan dalam parameter RootPath . Kedalaman jalur maksimum yang diizinkan di RootPath adalah 32 direktori. Ketika fungsi menemukan file di pohon direktori, fungsi menempatkan jalur lengkap ke file dalam buffer yang ditentukan oleh parameter OutputPathBuffer . Sistem file yang mendasar menentukan urutan pencarian subdirektori.

Pencarian dapat dibatalkan jika Anda mendaftarkan fungsi panggilan balik SymRegisterCallbackProc64 . Untuk setiap direktori yang dicari, SearchTreeForFile memanggil fungsi panggilan balik ini dengan CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Jika fungsi panggilan balik mengembalikan TRUE, SearchTreeForFile membatalkan pencarian.

Fungsi ini memicu satu peristiwa CBA_DEFERRED_SYMBOL_LOAD_CANCEL per direktori yang dicari. Ini memungkinkan pemanggil untuk 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 5.1 atau yang lebih baru

Lihat juga

DbgHelp Functions