Fungsi EnumDirTreeW (dbghelp.h)

Artikel
11/20/2024

Menghitung semua kemunculan file yang ditentukan di pohon direktori yang ditentukan.

Sintaksis

BOOL IMAGEAPI EnumDirTreeW(
  [in, optional]  HANDLE                 hProcess,
  [in]            PCWSTR                 RootPath,
  [in]            PCWSTR                 InputPathName,
  [out, optional] PWSTR                  OutputPathBuffer,
  [in, optional]  PENUMDIRTREE_CALLBACKW 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 NULL.

[in, optional] cb

Fungsi panggilan balik yang ditentukan aplikasi, atau NULL. Untuk informasi selengkapnya, lihatEnumDirTreeProc .

[in, optional] data

Data yang ditentukan pengguna atau null. Nilai ini diteruskan ke fungsi panggilan balik.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

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 yang ini, berutas 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.

Nota

Header dbghelp.h mendefinisikan EnumDirTree sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	dbghelp.h
Pustaka	Dbghelp.lib
DLL	Dbghelp.dll
Redistributable	DbgHelp.dll 6.0 atau yang lebih baru

Lihat juga

DbgHelp Functions

EnumDirTreeProc

Bagikan melalui