IDebugSymbols3::GetFunctionEntryByOffset 方法 (dbgeng.h)
GetFunctionEntryByOffset 方法會傳回函式的函式項目資訊。
語法
HRESULT GetFunctionEntryByOffset(
[in] ULONG64 Offset,
[in] ULONG Flags,
[out, optional] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG BufferNeeded
);
參數
[in] Offset
指定目前進程的虛擬位址空間中函式實作的位置。 這是 GetNextSymbolMatch 和 IDebugSymbolGroup::GetSymbolOffset的 Offset 參數中傳回的值,以及 DEBUG_SYMBOL_ENTRY 結構中 Offset 字段的值。
[in] Flags
指定改變這個方法行為的位旗標。 如果未設定位DEBUG_GETFNENT_RAW_ENTRY_ONLY,引擎會提供已知案例的人工專案。 如果設定此位,則不會使用人工專案。
[out, optional] Buffer
接收函式項目資訊。 如果有效處理器是 x86,則這是函式的FPO_DATA結構。 對於所有其他架構,這是該架構IMAGE_FUNCTION_ENTRY結構。
[in] BufferSize
指定緩衝區的大小 Buffer。
[out, optional] BufferNeeded
指定函式項目資訊的大小。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
|
方法成功,但緩衝區不夠大,無法保存函式項目資訊,因此資訊已截斷以符合。 |
|
找不到位置 Offset的函式項目資訊。 |
言論
結構FPO_DATA和IMAGE_FUNCTION_ENTRY記載於 DbgHelp.chm 檔案中的 Windows 偵錯工具中。
附註「影像說明連結庫」和「偵錯說明連結庫」中的函式,不應由任何擴充功能或調試程式引擎應用程式呼叫。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h, Winnt.h) |