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
接收名称 名称的第一个模块的索引。 如果 索引NULL,则不会返回此信息。
[out, optional] Base
接收目标模块基的内存地址空间中的位置。 如果 BaseNULL,则不会返回此信息。
返回值
此方法还可以返回其他错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
|
传入的参数之一无效。 |
言论
从指定的索引开始,这些方法返回使用指定名称找到的第一个模块。 如果目标具有多个具有此名称的模块,则可以通过对这些方法的重复调用找到后续模块,这些方法的值 StartIndex。
有关模块的详细信息,请参阅 模块。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |