IDebugSymbols3：：GetFunctionEntryByOffset 方法 (dbgeng.h)

發行項
02/23/2024

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

指定緩衝區 緩衝區的大小。

[out, optional] BufferNeeded

指定函式項目資訊的大小。

傳回值

這個方法也可能傳回錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	此方法成功。
S_FALSE	方法成功，但緩衝區不夠大，無法保存函式項目資訊，因此已截斷資訊以符合。
E_NOINTERFACE	找不到位置 Offset 的函式項目資訊。