IDebugSymbols3::GetModuleByModuleName2 方法 (dbgeng.h)
GetModuleByModuleName2 方法在进程的模块中搜索具有指定名称的模块。
语法
HRESULT GetModuleByModuleName2(
[in] PCSTR 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,则不会返回此信息。
返回值
此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
传入的参数之一无效。 |
注解
从指定的索引开始,这些方法返回它们找到的第一个具有指定名称的模块。 如果目标有多个具有此名称的模块,则可以通过重复调用这些具有较高 StartIndex 值的方法找到后续模块。
有关模块的详细信息,请参阅 模块。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |