Fungsi SymSearch (dbghelp.h)

Mencari simbol PDB yang memenuhi kriteria yang ditentukan.

Sintaks

BOOL IMAGEAPI SymSearch(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        BaseOfDll,
  [in, optional] DWORD                          Index,
  [in, optional] DWORD                          SymTag,
  [in, optional] PCSTR                          Mask,
  [in, optional] DWORD64                        Address,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in, optional] PVOID                          UserContext,
  [in]           DWORD                          Options
);

Parameter

[in] hProcess

Handel ke proses. Handel ini sebelumnya harus diteruskan ke fungsi SymInitialize .

[in] BaseOfDll

Alamat dasar modul. Jika nilai ini nol dan Mask berisi tanda seru (!), fungsi akan melihat seluruh modul. Jika nilai ini nol dan Mask tidak berisi tanda seru, fungsi menggunakan cakupan yang ditetapkan oleh fungsi SymSetContext .

[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 pointer ke struktur data yang menyediakan konteks untuk fungsi panggilan balik.

[in] Options

Opsi yang mengontrol perilaku fungsi ini.

Nilai kembali

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

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

Lihat juga

DbgHelp Functions

SymEnumSymbolsProc