IDebugHostModule interface (dbgmodel.h)
An (IDebugHostSymbol derived) interface to a particular module.
Inheritance
IDebugHostModule inherits from IDebugHostSymbol.
Methods
The IDebugHostModule interface has these methods.
| IDebugHostModule::AddRef The IDebugHostModule::AddRef method increments the reference count for an interface on an object. |
| IDebugHostModule::EnumerateChildren The IDebugHostModule::EnumerateChildren method gets an enumerator capable of enumerating all children of a given symbol. |
| IDebugHostModule::FindSymbolByName The IDebugHostModule::FindSymbolByName method, when called on a module, retrieves a global symbol by name from within the module. |
| IDebugHostModule::FindSymbolByRVA The IDebugHostModule::FindSymbolByRVA method, when called on a module, retrieves a symbol at a given relative virtual address within the module. |
| IDebugHostModule::FindTypeByName The IDebugHostModule::FindTypeByName method, when called on a module, finds a type by type name from within the module and retrieves a type symbol for it. |
| IDebugHostModule::GetBaseLocation The IDebugHostModule::GetBaseLocation method, when called on a module, gets the base loading address of the module as a location structure. |
| IDebugHostModule::GetContainingModule The IDebugHostModule::GetContainingModule method, when called on a symbol, gets the module that contains the symbol if the symbol has a containing module. |
| IDebugHostModule::GetContext The IDebugHostModule::GetContext method, when called on a symbol, gets the host context in which the symbol is located. |
| IDebugHostModule::GetImageName The IDebugHostModule::GetImageName method gets the image name or full path of the module as an allocated string. |
| IDebugHostModule::GetName The IDebugHostModule::GetName method, when called on a symbol, gets the name of the symbol if it has a name. |
| IDebugHostModule::GetSymbolKind The IDebugHostModule::GetSymbolKind method, when called on a symbol, gets the kind of symbol, such as field, base class, or type. |
| IDebugHostModule::GetType The IDebugHostModule::GetType method, when called on a symbol, gets the type of symbol, such as int *. |
| IDebugHostModule::GetVersion The IDebugHostModule::GetVersion method, when called on a module, gets module version information from the module headers. |
| IDebugHostModule::QueryInterface The IDebugHostModule::QueryInterface method retrieves pointers to the supported interfaces on an object. |
| IDebugHostModule::Release The IDebugHostModule::Release method decrements the reference count for an interface on an object. |
Remarks
The debugger's notion of a module that is loaded within some address space is represented in two distinct ways in the data model:
At the type system level via the IDebugHostModule interface. Here, a module is a symbol and core attributes of the module are interface method calls
Projected at the data model level via the Debugger.Models.Module data model. This is an extensible encapsulation of the type system IDebugHostModule representation of a module.
Requirements
| Requirement | Value |
|---|---|
| Header | dbgmodel.h |