IDebugHostModule2 interface (dbgmodel.h)

An (IDebugHostSymbol derived) interface to a particular module.

This version 2 of the interface supports all of the previous methods with identical signatures and includes additional new methods that provide added functionality. The new methods are listed in the header at the end of the section for that interface.

Inheritance

IDebugHostModule2 inherits from IDebugHostModule.

Methods

The IDebugHostModule2 interface has these methods.

IDebugHostModule2::AddRef The IDebugHostModule2::AddRef method increments the reference count for an interface on an object.
IDebugHostModule2::EnumerateChildren The IDebugHostModule2::EnumerateChildren method gets an enumerator capable of enumerating all children of a given symbol.
IDebugHostModule2::FindContainingSymbolByRVA The IDebugHostModule2::FindContainingSymbolByRVA method, when called on a module, retrieves a symbol at a given relative virtual address within the module.
IDebugHostModule2::FindSymbolByName The IDebugHostModule2::FindSymbolByName method, when called on a module, retrieves a global symbol by name from within the module.
IDebugHostModule2::FindSymbolByRVA The IDebugHostModule2::FindSymbolByRVA method, when called on a module, retrieves a symbol at a given relative virtual address within the module.
IDebugHostModule2::FindTypeByName The IDebugHostModule2::FindTypeByName method, when called on a module, finds a type by type name from within the module and retrieves a type symbol for it.
IDebugHostModule2::GetBaseLocation The IDebugHostModule2::GetBaseLocation method, when called on a module, gets the base loading address of the module as a location structure.
IDebugHostModule2::GetContainingModule The IDebugHostModule2::GetContainingModule method, when called on a symbol, gets the module that contains the symbol if the symbol has a containing module.
IDebugHostModule2::GetContext The IDebugHostModule2::GetContext method, when called on a symbol, gets the host context in which the symbol is located.
IDebugHostModule2::GetImageName The IDebugHostModule2::GetImageName method gets the image name or full path of the module as an allocated string.
IDebugHostModule2::GetName The IDebugHostModule2::GetName method, when called on a symbol, gets the name of the symbol if it has a name.
IDebugHostModule2::GetSymbolKind The IDebugHostModule2::GetSymbolKind method, when called on a symbol, gets the kind of symbol, such as field, base class, or type.
IDebugHostModule2::GetType The IDebugHostModule2::GetType method, when called on a symbol, gets the type of symbol, such as int *.
IDebugHostModule2::GetVersion The IDebugHostModule2::GetVersion method, when called on a module, gets module version information from the module headers.
IDebugHostModule2::QueryInterface The IDebugHostModule2::QueryInterface method retrieves pointers to the supported interfaces on an object.
IDebugHostModule2::Release The IDebugHostModule2::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

See also

Debugger Data Model C++ Overview