IDebugSymbols::GetModuleByOffset メソッド (dbgeng.h)

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

GetModuleByOffset メソッドは、ターゲットのモジュールを検索して、メモリ割り当てに指定された場所が含まれるモジュールを検索します。

構文

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

パラメーター

[in] Offset

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

[in] StartIndex

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

[out, optional] Index

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

[out, optional] Base

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

戻り値

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

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

注釈

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

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