Metode IDebugSymbols3::GetNameByOffsetWide (dbgeng.h)

  • Artikel

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

Sintaks

HRESULT GetNameByOffsetWide(
  [in]            ULONG64  Offset,
  [out, optional] PWSTR    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 NameBufferNULL, informasi ini tidak dikembalikan.

[in] NameBufferSize

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

[out, optional] NameSize

Menerima ukuran dalam karakter nama simbol. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. 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.

Keterangan

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

Persyaratan

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

Lihat juga

GetNearNameByOffset

GetOffsetByName

IDebugSymbols3