IDebugSymbols3::AddSyntheticModuleWide method (dbgeng.h)

Article
02/22/2024

The AddSyntheticModuleWide method adds a synthetic module to the module list the debugger maintains for the current process.

Syntax

HRESULT AddSyntheticModuleWide(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCWSTR  ImagePath,
  [in] PCWSTR  ModuleName,
  [in] ULONG   Flags
);

Parameters

[in] Base

Specifies the location in the process's virtual address space of the base of the synthetic module.

[in] Size

Specifies the size in bytes of the synthetic module.

[in] ImagePath

Specifies the image name of the synthetic module. This is the name that will be returned as the name of the executable file for the synthetic module. The full path should be included if known.

[in] ModuleName

Specifies the module name for the synthetic module.

[in] Flags

Set to DEBUG_ADDSYNTHMOD_DEFAULT.

Return value

Return code	Description
S_OK	The method was successful.

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

Remarks

The memory region of the synthetic module, described by the Base and Size parameters, must not overlap the memory region of any other module.

If all the modules are reloaded - for example, by calling Reload with the Module parameter set to an empty string - all synthetic modules will be discarded.

For more information about synthetic modules, see Synthetic Modules.

Requirements

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