Fungsi SymGetSymFromName (dbghelp.h)

Artikel
08/23/2023

Menemukan simbol untuk nama yang ditentukan.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas. Aplikasi harus menggunakan SymFromName.

Sintaks

BOOL IMAGEAPI SymGetSymFromName(
  [in]      HANDLE           hProcess,
  [in]      PCSTR            Name,
  [in, out] PIMAGEHLP_SYMBOL Symbol
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in] Name

Nama simbol tempat simbol akan berada.

[in, out] Symbol

Penunjuk ke struktur IMAGEHLP_SYMBOL64 .

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

Fungsi SymGetSymFromName64 digunakan untuk menemukan simbol untuk nama tertentu. Nama dapat berisi awalan modul yang mengisolasi pencarian simbol ke tabel simbol modul tunggal.

Awalan modul dalam bentuk "modul!". Karakter "!" adalah pemisah antara nama modul dan nama simbol. Jika tidak ada awalan modul, maka pencarian dilakukan pada setiap tabel simbol modul secara linier, dimulai dengan modul pertama yang dimuat.

Menggunakan awalan modul lebih disukai karena dua alasan. Pertama, pencarian simbol terjadi jauh lebih cepat. Kedua, ketika pemuatan simbol yang ditangguhkan diaktifkan, pencarian menyebabkan simbol dimuat untuk setiap modul yang dicari. Ketika simbol ditemukan, informasi simbol disalin ke dalam buffer Simbol yang disediakan oleh pemanggil. Pemanggil harus mengalokasikan buffer Simbol dengan benar dan mengisi parameter yang diperlukan dalam struktur IMAGEHLP_SYMBOL64 sebelum memanggil SymGetSymFromName64.

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.

Fungsi ini menggantikan fungsi SymGetSymFromName . Untuk informasi selengkapnya, lihat Dukungan Platform yang Diperbarui. SymGetSymFromName didefinisikan sebagai berikut dalam Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymFromName SymGetSymFromName64
#else
BOOL
IMAGEAPI
SymGetSymFromName(
    __in HANDLE hProcess,
    __in PCSTR Name,
    __inout PIMAGEHLP_SYMBOL Symbol
    );
#endif