IDebugSymbols3::GetFunctionEntryByOffset メソッド (dbgeng.h)

[アーティクル]
08/07/2023

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 の関数エントリ情報が見つかりませんでした。