Metode IDebugSymbols2::GetSourceFileLineOffsets (dbgeng.h)

Artikel
02/23/2024

Metode GetSourceFileLineOffsets memetakan setiap baris dalam file sumber ke lokasi di memori target.

Sintaks

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

Parameter

[in] File

Menentukan nama file yang barisnya akan diubah menjadi lokasi dalam memori target. Simbol untuk setiap modul dalam target dikueri untuk file ini. Jika file tidak ditemukan, jalur dihilangkan dan simbol dikueri lagi.

[out, optional] Buffer

Menerima lokasi dalam memori target yang sesuai dengan baris kode sumber. Entri pertama yang dikembalikan ke array ini sesuai dengan baris pertama file, sehingga Buffer[i] berisi lokasi untuk baris i+1. Jika tidak ada informasi simbol yang tersedia untuk baris, entri yang sesuai di Buffer diatur ke DEBUG_INVALID_OFFSET. Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferLines

Menentukan jumlah objek PULONG64 yang dapat ditahan oleh array Buffer .

[out, optional] FileLines

Menerima jumlah baris dalam file sumber yang ditentukan oleh File.

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, jumlah baris dalam file sumber melebihi jumlah entri dalam array Buffer dan beberapa hasilnya dibuang.