Fungsi SymSearchW (dbghelp.h)

Artikel
11/20/2024

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 SymInitialize.

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

[in] Options

Opsi yang mengontrol perilaku fungsi ini.

Nilai	Arti
SYMSEARCH_ALLITEMS 0x08	Sertakan semua simbol dan data lainnya dalam file .pdb. DbgHelp 6.6 dan yang lebih lama: Nilai ini tidak didukung.
SYMSEARCH_GLOBALSONLY 0x04	Cari simbol global saja.
SYMSEARCH_MASKOBJS 0x01	Hanya untuk penggunaan internal.
SYMSEARCH_RECURSE 0x02	Berulang dari bagian atas untuk menemukan semua simbol.

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
Redistributable	DbgHelp.dll 6.2 atau yang lebih baru

Lihat juga

DbgHelp Functions

SymEnumSymbolsProc

Bagikan melalui