This topic has not yet been rated - Rate this topic

IDebugSymbols3::AddSyntheticModuleWide method

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

Syntax

Copy

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

Parameters

Base [in]: Specifies the location in the process's virtual address space of the base of the synthetic module.
Size [in]: Specifies the size in bytes of the synthetic module.
ImagePath [in]: 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.
ModuleName [in]: Specifies the module name for the synthetic module.
Flags [in]: 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