Metode IDebugSymbols2::GetNameByOffset (dbgeng.h)

Artikel
02/23/2024

Metode GetNameByOffset mengembalikan nama simbol di lokasi yang ditentukan di ruang alamat virtual target.

Sintaks

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

Parameter

[in] Offset

Menentukan lokasi di ruang alamat virtual target dari simbol yang namanya diminta. Offset tidak perlu menentukan lokasi dasar simbol; hanya perlu menentukan lokasi dalam alokasi memori simbol.

[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 dasar simbol. 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_FAIL	Tidak ada simbol yang dapat ditemukan di lokasi yang ditentukan.