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

[アーティクル]
02/23/2024

GetModuleByOffset2 メソッドは、メモリ割り当てに指定された場所が含まれているモジュールをプロセスのモジュールで検索します。

構文

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

パラメーター

[in] Offset

ターゲットの仮想アドレス空間内の、目的のモジュールのメモリ割り当て内の場所 (たとえば、モジュールに属するシンボルのアドレス) を指定します。

[in] StartIndex

検索を開始するインデックスを指定します。

[in] Flags

指定した場所でモジュールを検索するときに使用されるオプションを含むビットセットを指定します。 フラグ には、次のビットフラグが含まれる場合があります。

フラグ	結果
DEBUG_GETMOD_NO_LOADED_MODULES	読み込まれたモジュールを検索しないでください。
DEBUG_GETMOD_NO_UNLOADED_MODULES	アンロードされたモジュールを検索しないでください。

[out, optional] Index

モジュールのインデックスを受け取ります。 Index が NULL の場合、この情報は返されません。

[out, optional] Base

モジュールのベースのターゲットのメモリアドレス空間内の場所を受け取ります。 Base が NULL の場合、この情報は返されません。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

注釈

指定したインデックス以降、このメソッドは、メモリ割り当てアドレス範囲に指定した場所が含まれている最初のモジュールを返します。ターゲットに複数のモジュールがあり、そのメモリアドレス範囲にこの場所が含まれている場合は、 StartIndex の値が大きいこのメソッドを繰り返し呼び出すことで、後続のモジュールを見つけることができます。

モジュールの詳細については、「モジュール」を参照してください。