IDebugSymbols::GetModuleParameters method (dbgeng.h)

Article
02/22/2024

The GetModuleParameters method returns parameters for modules in the target.

Syntax

HRESULT GetModuleParameters(
  [in]           ULONG                    Count,
  [in, optional] PULONG64                 Bases,
  [in]           ULONG                    Start,
  [out]          PDEBUG_MODULE_PARAMETERS Params
);

Parameters

[in] Count

Specifies the number of modules whose parameters are desired.

[in, optional] Bases

Specifies an array of locations in the target's virtual address space representing the base address of the modules whose parameters are desired. The size of this array is the value of Count. If Bases is NULL, the Start parameter is used to specify the modules by index.

[in] Start

Specifies the index of the first module whose parameters are desired. If Bases is not NULL, this parameter is ignored.

[out] Params

Receives the parameters. The size of this array is the value of Count. See DEBUG_MODULE_PARAMETERS.

Return value

This method may also return other error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful. However, if Bases is not NULL, it is possible that not all of the modules were found, in which case partial results are returned.
E_INVALIDARG	When Bases is NULL, this value indicates that the target contains fewer than the sum of Count and Start modules. Partial results are returned.

Remarks

In the cases when partial results are returned, the entries in the array Params corresponding to modules that could not be found have their Base field set to DEBUG_INVALID_OFFSET. See DEBUG_MODULE_PARAMETERS.

For more information about modules, see Modules.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)