Metode IDebugSymbols2::GetNearNameByOffset (dbgeng.h)

Artikel
02/23/2024

Metode GetNearNameByOffset mengembalikan nama simbol yang terletak di dekat lokasi yang ditentukan.

Sintaks

HRESULT GetNearNameByOffset(
  [in]            ULONG64  Offset,
  [in]            LONG     Delta,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

Parameter

[in] Offset

Menentukan lokasi dalam ruang alamat virtual target dari simbol tempat simbol yang diinginkan ditentukan.

[in] Delta

Menentukan hubungan antara simbol yang diinginkan dan simbol yang terletak di Offset. Jika positif, mesin akan mengembalikan simbol delta setelah simbol yang terletak di Offset. Jika negatif, mesin akan mengembalikan simbol yang merupakan simbol Delta sebelum simbol yang terletak di Offset.

[out, optional] NameBuffer

Menerima nama simbol. Nama ini memenuhi syarat oleh modul tempat simbol berada (misalnya, mymodule!main). Jika NameBufferADALAH NULL, informasi ini tidak dikembalikan.

[in] NameBufferSize

Menentukan ukuran dalam karakter buffer NameBuffer. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri.

[out, optional] NameSize

Menerima ukuran dalam karakter nama simbol. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri. Jika NameSizeNULL, informasi ini tidak dikembalikan.

[out, optional] Displacement

Menerima perbedaan antara nilai Offset dan lokasi di ruang alamat memori simbol target. Jika PerpindahanNULL, informasi ini tidak dikembalikan.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Metode berhasil. Namun, buffer tidak cukup besar untuk menahan nama simbol sehingga terpotong.
E_NOINTERFACE	Tidak ada simbol yang cocok dengan spesifikasi Offset dan Delta yang ditemukan.

Keterangan

Dengan meningkatkan atau mengurangi nilai Delta, metode ini dapat digunakan untuk melakukan iterasi pada simbol target yang dimulai pada lokasi tertentu.

Jika Delta nol, metode ini bersifat sama seperti GetNameByOffset.

Untuk informasi selengkapnya tentang simbol dan nama simbol, lihat Simbol.