IDebugSymbols3::GetModuleByModuleName メソッド (dbgeng.h)
GetModuleByModuleName メソッドは、ターゲットのモジュールを検索して、指定した名前のモジュールを検索します。
構文
HRESULT GetModuleByModuleName(
[in] PCSTR Name,
[in] ULONG StartIndex,
[out, optional] PULONG Index,
[out, optional] PULONG64 Base
);
パラメーター
[in] Name
目的のモジュールの名前を指定します。
[in] StartIndex
検索を開始するインデックスを指定します。
[out, optional] Index
Name という名前の最初のモジュールのインデックスを受け取 ります。 Index が NULL の場合、この情報は返されません。
[out, optional] Base
モジュールのベースのターゲットのメモリ アドレス空間内の場所を受け取ります。 Base が NULL の場合、この情報は返されません。
戻り値
このメソッドは、他のエラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
渡された引数の 1 つが無効です。 |
注釈
指定したインデックス以降、これらのメソッドは、指定した名前で見つけた最初のモジュールを返します。 ターゲットにこの名前のモジュールが複数ある場合は、 StartIndex の値が大きいこれらのメソッドを繰り返し呼び出すことで、後続のモジュールを見つけることができます。
モジュールの詳細については、「 モジュール」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |