Metode IDebugSymbols3::GetFunctionEntryByOffset (dbgeng.h)

Artikel
02/23/2024

Metode GetFunctionEntryByOffset mengembalikan informasi entri fungsi untuk fungsi.

Sintaks

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

Parameter

[in] Offset

Menentukan lokasi di ruang alamat virtual proses saat ini dari implementasi fungsi. Ini adalah nilai yang dikembalikan dalam parameter OffsetGetNextSymbolMatch dan IDebugSymbolGroup::GetSymbolOffset, dan nilai bidang Offset dalam struktur DEBUG_SYMBOL_ENTRY .

[in] Flags

Menentukan bendera bit yang mengubah perilaku metode ini. Jika bit DEBUG_GETFNENT_RAW_ENTRY_ONLY tidak diatur, mesin akan memberikan entri buatan untuk kasus-kasus terkenal. Jika bit ini diatur, entri buatan tidak digunakan.

[out, optional] Buffer

Menerima informasi entri fungsi. Jika prosesor yang efektif adalah x86, ini adalah struktur FPO_DATA untuk fungsi. Untuk semua arsitektur lainnya, ini adalah struktur IMAGE_FUNCTION_ENTRY untuk arsitektur tersebut.

[in] BufferSize

Menentukan ukuran buffer Buffer.

[out, optional] BufferNeeded

Menentukan ukuran informasi entri fungsi.

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, tetapi buffer tidak cukup besar untuk menyimpan informasi entri fungsi dan sehingga informasi dipotong agar pas.
E_NOINTERFACE	Tidak ada informasi entri fungsi yang ditemukan untuk lokasi Offset.

Keterangan

Struktur FPO_DATA dan IMAGE_FUNCTION_ENTRY didokumenkan dalam "Pustaka Bantuan Gambar" yang disertakan dalam Alat Penelusuran Kesalahan Untuk Windows dalam file DbgHelp.chm.

Catatan Fungsi dalam "Pustaka Bantuan Gambar" dan "Pustaka Bantuan Debug", yang di dokumentasikan dalam DbgHelp.chm, tidak boleh dipanggil oleh aplikasi mesin ekstensi atau debugger apa pun.

Untuk informasi selengkapnya tentang simbol, lihat Simbol.