Metode IDebugSymbols3::GetSourceEntriesByLine (dbgeng.h)

Artikel
08/10/2023

Metode GetSourceEntriesByLine meminta informasi simbol dan mengembalikan lokasi di memori target yang sesuai dengan baris dalam file sumber.

Sintaks

HRESULT GetSourceEntriesByLine(
  [in]                    ULONG                      Line,
  [in]                    PCSTR                      File,
  [in]                    ULONG                      Flags,
  [out, writes, optional] PDEBUG_SYMBOL_SOURCE_ENTRY Entries,
  [in]                    ULONG                      EntriesCount,
  [out, optional]         PULONG                     EntriesAvail
);

Parameter

[in] Line

Menentukan baris dalam file sumber yang akan dikueri. Angka untuk baris pertama adalah 1.

[in] File

Menentukan file sumber. Simbol untuk setiap modul dalam target dikueri untuk file ini.

[in] Flags

Menentukan bendera bit yang mengontrol perilaku metode ini. Bendera dapat berupa kombinasi nilai apa pun dari tabel berikut.

Nilai	Deskripsi
DEBUG_GSEL_NO_SYMBOL_LOADS	Mesin debugger hanya akan mencari file di antara modul yang simbolnya telah dimuat. Simbol untuk modul lain tidak akan dimuat. Jika opsi ini tidak diatur, mesin debugger akan memuat simbol untuk semua modul hingga menemukan file yang ditentukan dalam File.
DEBUG_GSEL_ALLOW_LOWER	Sertakan semua baris dalam File sebelum Baris dalam hasil.
DEBUG_GSEL_ALLOW_HIGHER	Sertakan semua baris dalam File setelah Baris dalam hasil.
DEBUG_GSEL_NEAREST_ONLY	Hanya kembalikan paling banyak satu hasil. Jika DEBUG_GSEL_ALLOW_LOWER atau DEBUG_GSEL_ALLOW_HIGHER diatur, hasil yang dikembalikan akan menjadi untuk garis yang dekat dengan Garis tetapi tidak boleh Garis jika tidak ada informasi simbol untuk baris tersebut.

Untuk menggunakan kumpulan bendera default, atur Bendera ke DEBUG_GSEL_DEFAULT. Ini memiliki semua bendera dalam tabel sebelumnya dinonaktifkan.

[out, writes, optional] Entries

Menerima lokasi dalam memori target yang sesuai dengan baris sumber yang dikueri. Setiap entri dalam array ini berjenis DEBUG_SYMBOL_SOURCE_ENTRY dan berisi nomor baris sumber bersama dengan lokasi dalam memori target.

[in] EntriesCount

Menentukan jumlah entri dalam array Entri .

[out, optional] EntriesAvail

Menerima jumlah lokasi yang cocok dengan kueri yang ditemukan dalam memori target.

Nilai kembali

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, array Entries tidak cukup besar untuk menyimpan semua hasil yang cocok dengan kueri dan hasil tambahan dibuang.
E_NOINTERFACE	Kueri tidak menghasilkan hasil. Ini termasuk kasus di mana informasi simbol tidak tersedia untuk file yang ditentukan.

Keterangan

Metode ini dapat digunakan oleh aplikasi debugger untuk mengambil lokasi di memori target untuk mengatur titik henti atau mencocokkan kode sumber dengan instruksi yang dibongkar. Misalnya, mengatur bendera DEBUG_GSEL_ALLOW_HIGHER dan DEBUG_GSEL_NEAREST_ONLY akan mengembalikan lokasi memori target untuk bagian kode pertama yang dimulai pada baris yang ditentukan.

Untuk informasi selengkapnya tentang file sumber, lihat Menggunakan File Sumber.