Debugging Tools for Windows |
The GetModuleByModuleName and GetModuleByModuleNameWide methods search through the target's modules for one with the specified name.
HRESULT
IDebugSymbols::GetModuleByModuleName(
IN PCSTR Name,
IN ULONG StartIndex,
OUT OPTIONAL PULONG Index,
OUT OPTIONAL PULONG64 Base
);
HRESULT
IDebugSymbols::GetModuleByModuleNameWide(
IN PCWSTR Name,
IN ULONG StartIndex,
OUT OPTIONAL PULONG Index,
OUT OPTIONAL PULONG64 Base
);
#ifdef UNICODE
#define GetModuleByModuleNameT GetModuleByModuleNameWide
#else
#define GetModuleByModuleNameT GetModuleByModuleName
#endif
This method may also return other error values. See Return Values for more details.
GetModuleByModuleName is available in all versions of IDebugSymbols. GetModuleByModuleNameWide is available in IDebugSymbols3 and later versions.
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.
Headers: Defined in Dbgeng.h. Include Dbgeng.h.