Metode IDebugSymbols3::GetNearNameByOffsetWide (dbgeng.h)
Metode GetNearNameByOffsetWide mengembalikan nama simbol yang terletak di dekat lokasi yang ditentukan.
Sintaks
HRESULT GetNearNameByOffsetWide(
[in] ULONG64 Offset,
[in] LONG Delta,
[out, optional] PWSTR 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 |
---|---|
|
Metode berhasil. |
|
Metode berhasil. Namun, buffer tidak cukup besar untuk menahan nama simbol sehingga terpotong. |
|
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (termasuk Dbgeng.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk