IDebugSymbols3::GetModuleByModuleName2 method (dbgeng.h)
The GetModuleByModuleName2 method searches through the process's modules for one with the specified name.
Syntax
HRESULT GetModuleByModuleName2(
[in] PCSTR Name,
[in] ULONG StartIndex,
[in] ULONG Flags,
[out, optional] PULONG Index,
[out, optional] PULONG64 Base
);
Parameters
[in] Name
Specifies the name of the desired module.
[in] StartIndex
Specifies the index to start searching from.
[in] Flags
Specifies a bit-set containing options used when searching for the module with the specified name. Flags may contain the following bit-flags:
Flag | Effect |
---|---|
DEBUG_GETMOD_NO_LOADED_MODULES | Do not search the loaded modules. |
DEBUG_GETMOD_NO_UNLOADED_MODULES | Do not search the unloaded modules. |
[out, optional] Index
Receives the index of the first module with the name Name. If Index is NULL, this information is not returned.
[out, optional] Base
Receives the location in the target's memory address space of the base of the module. If Base is NULL, this information is not returned.
Return value
This method may also return other error values. See Return Values for more details.
Return code | Description |
---|---|
|
The method was successful. |
|
One of the arguments passed in was invalid. |
Remarks
Starting at the specified index, these methods return the first module they find with the specified name. If the target has more than one module with this name, then subsequent modules can be found by repeated calls to these methods with higher values of StartIndex.
For more information about modules, see Modules.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (include Dbgeng.h) |