Fungsi SymFromNameW (dbghelp.h)

Artikel
11/20/2024

Mengambil informasi simbol untuk nama yang ditentukan.

Sintaksis

BOOL IMAGEAPI SymFromNameW(
  [in]      HANDLE        hProcess,
  [in]      PCWSTR        Name,
  [in, out] PSYMBOL_INFOW Symbol
);

Parameter

[in] hProcess

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

[in] Name

Nama simbol yang akan ditemukan.

[in, out] Symbol

Penunjuk ke struktur SYMBOL_INFO yang menyediakan informasi tentang 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.

Contoh

Misalnya, lihat Mengambil Informasi Simbol berdasarkan Nama.

Nota

Header dbghelp.h mendefinisikan SymFromName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 5.1 atau yang lebih baru

Lihat juga

DbgHelp Functions

SYMBOL_INFO

Bagikan melalui