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