IDebugSymbols3::AddSyntheticSymbol method

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

Syntax


HRESULT AddSyntheticSymbol(
  [in]             ULONG64 Offset,
  [in]             ULONG Size,
  [in]             PCSTR Name,
  [in]             ULONG Flags,
  [out, optional]  PDEBUG_MODULE_AND_ID Id
);

Parameters

Offset [in]

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

Size [in]

Specifies the size in bytes of the synthetic symbol.

Name [in]

Specifies the name of the synthetic symbol.

Flags [in]

Set to DEBUG_ADDSYNTHSYM_DEFAULT.

Id [out, optional]

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

Return value

Return codeDescription
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

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugSymbols3
RemoveSyntheticSymbol
AddSyntheticModule

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft