IDebugSymbols3::AddSyntheticSymbol method

The AddSyntheticSymbol method adds a synthetic symbol to a module in the current process.

Syntax

HRESULT AddSyntheticSymbol(
  ULONG64              Offset,
  ULONG                Size,
  PCSTR                Name,
  ULONG                Flags,
  PDEBUG_MODULE_AND_ID Id
);

Parameters

Offset

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

Size

Specifies the size in bytes of the synthetic symbol.

Name

Specifies the name of the synthetic symbol.

Flags

Set to DEBUG_ADDSYNTHSYM_DEFAULT.

Id

Receives the DEBUG_MODULE_AND_ID structure that identifies the synthetic symbol. If Id is NULL, this information is not returned.

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 location of the synthetic symbol must not be the same as the location of another symbol.

If the module containing a synthetic symbol is reloaded - for example, by calling Reload with the Module parameter set to the name of the module - the synthetic symbol will be discarded.

For more information about synthetic symbols, see Synthetic Symbols.

Requirements

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

See Also

AddSyntheticModule

IDebugSymbols3

RemoveSyntheticSymbol