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

Mengembalikan nilai

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.
S_FALSE
Metode berhasil. Namun, informasi tidak akan pas di buffer Buffer atau string tidak akan pas di buffer StringBuffer, sehingga informasi atau nama terpotok.

Persyaratan

   
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)