Metode IDebugAdvanced4::GetSymbolInformationWideEx (dbgeng.h)
Metode GetSymbolInformationWideEx mengembalikan informasi tertentu tentang simbol.
Sintaks
HRESULT GetSymbolInformationWideEx(
[in] ULONG Which,
[in] ULONG64 Arg64,
[in] ULONG Arg32,
[out, optional] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG InfoSize,
[out, optional] PWSTR StringBuffer,
[in] ULONG StringBufferSize,
[out, optional] PULONG StringSize,
[out, optional] PSYMBOL_INFO_EX pInfoEx
);
Parameter
[in] Which
Menentukan bagian informasi yang akan dikembalikan. Yang dapat mengambil salah satu nilai dalam tabel berikut.
Nilai | Informasi yang dikembalikan |
---|---|
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE | Mengembalikan nama file kode sumber dan nomor baris untuk titik henti tertentu. Nomor baris dikembalikan ke Buffer sebagai ULONG. Nama file dikembalikan ke StringBuffer. |
DEBUG_SYMINFO_IMAGEHLP_MODULEW64 |
Mengembalikan struktur IMAGEHLP_MODULEW64 yang menjelaskan modul tertentu. Untuk detail tentang struktur ini, lihat topik IMAGEHLP_MODULE64 dalam dokumentasi Pustaka Bantuan Debug (dbghelp.chm).
Tidak ada string yang dikembalikan dan StringBuffer, StringBufferSize, dan StringSize semuanya harus diatur ke nol. |
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE | Mengembalikan nama Unicode dari simbol yang ditentukan oleh lokasi dalam memori dan jenis tag PDB. Nama dikembalikan ke Buffer. StringBuffer tidak digunakan. |
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS | Mengembalikan daftar nama simbol dan offset untuk simbol dalam modul yang ditentukan dengan jenis tag PDB yang ditentukan. Offset dikembalikan sebagai array nilai ULONG ke Buffer. Nama dikembalikan dalam urutan yang sama dengan offset ke StringBuffer. Beberapa nama mungkin berisi nol yang disematkan karena anotasi dapat memiliki nama multi-bagian; oleh karena itu, setiap nama dihentikan dengan dua karakter null. |
[in] Arg64
Menentukan argumen 64-bit. Parameter ini memiliki interpretasi berikut tergantung pada nilai Yang:
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE
Diabaikan.
DEBUG_SYMINFO_IMAGEHLP_MODULEW64
Alamat dasar modul yang deskripsinya sedang diminta.
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE
Menentukan alamat dalam memori target dari simbol yang namanya sedang diminta.
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS
Menentukan modul yang simbolnya diminta. Arg64 adalah lokasi dalam alokasi memori modul.
[in] Arg32
Menentukan argumen 32-bit. Parameter ini memiliki interpretasi berikut tergantung pada nilai Yang:
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE
ID titik henti mesin dari titik henti yang diinginkan.
DEBUG_SYMINFO_IMAGEHLP_MODULEW64
Atur ke nol.
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE
Klasifikasi PDB dari simbol . Arg32 harus menjadi salah satu nilai dalam enumerasi SymTagEnum yang ditentukan dalam Dbghelp.h. Untuk informasi selengkapnya, lihat dokumentasi PDB.
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS
Klasifikasi PDB dari simbol . Arg32 harus menjadi salah satu nilai dalam enumerasi SymTagEnum yang ditentukan dalam Dbghelp.h. Untuk informasi selengkapnya, lihat dokumentasi PDB.
[out, optional] Buffer
Menerima informasi simbol yang diminta. Jenis data yang dikembalikan tergantung pada nilai Yang. Jika BufferNULL, informasi ini tidak dikembalikan.
[in] BufferSize
Menentukan ukuran, dalam byte, buffer Buffer.
[out, optional] InfoSize
Jika metode ini mengembalikan S_OK, InfoSize menerima ukuran, dalam byte, dari informasi simbol yang dikembalikan ke Buffer. Jika metode ini mengembalikan S_FALSE, buffer yang disediakan tidak cukup besar, dan InfoSize menerima ukuran buffer yang diperlukan. Jika InfoSizeNULL, informasi ini tidak dikembalikan.
[out, optional] StringBuffer
Menerima string yang diminta. Interpretasi string ini tergantung pada nilai Yang. Jika StringBufferNULL, informasi ini tidak dikembalikan.
[in] StringBufferSize
Menentukan ukuran, dalam karakter, dari string buffer StringBuffer.
[out, optional] StringSize
Menerima ukuran, dalam karakter, dari string yang dikembalikan ke StringBuffer. Jika StringSizeNULL, informasi ini tidak dikembalikan.
[out, optional] pInfoEx
Penunjuk ke struktur SYMBOL_INFO_EX .
Nilai kembali
Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Metode berhasil. Namun, informasi tidak akan pas di buffer Buffer atau string tidak akan pas di buffer StringBuffer, sehingga informasi atau nama terpotong. |
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (termasuk Dbgeng.h) |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk