Fungsi SymSearchW (dbghelp.h)
Mencari simbol PDB yang memenuhi kriteria yang ditentukan.
Sintaksis
BOOL IMAGEAPI SymSearchW(
[in] HANDLE hProcess,
[in] ULONG64 BaseOfDll,
[in, optional] DWORD Index,
[in, optional] DWORD SymTag,
[in, optional] PCWSTR Mask,
[in, optional] DWORD64 Address,
[in] PSYM_ENUMERATESYMBOLS_CALLBACKW EnumSymbolsCallback,
[in, optional] PVOID UserContext,
[in] DWORD Options
);
Parameter
[in] hProcess
Handel ke proses. Handel ini sebelumnya harus diteruskan ke fungsi
[in] BaseOfDll
Alamat dasar modul. Jika nilai ini nol dan Mask berisi tanda seru (!), fungsi akan terlihat di seluruh modul. Jika nilai ini nol dan
[in, optional] Index
Nilai unik untuk simbol .
[in, optional] SymTag
Klasifikasi PDB. Nilai-nilai ini didefinisikan dalam Dbghelp.h dalam jenis enumerasi SymTagEnum. Untuk deskripsi, lihat dokumentasi PDB.
[in, optional] Mask
Ekspresi kartubebas yang menunjukkan nama simbol yang akan dijumlahkan. Untuk menentukan nama modul, gunakan !sintaks mod.
[in, optional] Address
Alamat simbol.
[in] EnumSymbolsCallback
Fungsi panggilan balik SymEnumSymbolsProc yang menerima informasi simbol.
[in, optional] UserContext
Nilai yang ditentukan pengguna yang diteruskan ke fungsi panggilan balik, atau NULL. Parameter ini biasanya digunakan oleh aplikasi untuk meneruskan penunjuk ke struktur data yang menyediakan konteks untuk fungsi panggilan balik.
[in] Options
Opsi yang mengontrol perilaku fungsi ini.
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
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 SymSearch sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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 |
|
DbgHelp.dll 6.2 atau yang lebih baru |