Skip to content

Latest commit

 

History

History
114 lines (79 loc) · 4.18 KB

nf-dbgeng-idebugsymbolgroup-addsymbol.md

File metadata and controls

114 lines (79 loc) · 4.18 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:dbgeng.IDebugSymbolGroup.AddSymbol
IDebugSymbolGroup::AddSymbol (dbgeng.h)
The AddSymbol method adds a symbol to a symbol group. This method belongs to the IDebugSymbolGroup interface.
debugger\addsymbol.htm
debugger
05/03/2018
IDebugSymbolGroup::AddSymbol
AddSymbol, AddSymbol method [Windows Debugging], AddSymbol method [Windows Debugging],IDebugSymbolGroup interface, AddSymbol method [Windows Debugging],IDebugSymbolGroup2 interface, ComOther_936851e7-6a8b-4b42-b339-9c8aa096d684.xml, IDebugSymbolGroup interface [Windows Debugging],AddSymbol method, IDebugSymbolGroup.AddSymbol, IDebugSymbolGroup2 interface [Windows Debugging],AddSymbol method, IDebugSymbolGroup2::AddSymbol, IDebugSymbolGroup::AddSymbol, dbgeng/IDebugSymbolGroup2::AddSymbol, dbgeng/IDebugSymbolGroup::AddSymbol, debugger.addsymbol
dbgeng.h
Dbgeng.h
Desktop
Windows
IDebugSymbolGroup::AddSymbol
dbgeng/IDebugSymbolGroup::AddSymbol
APIRef
kbSyntax
COM
Dbgeng.h
IDebugSymbolGroup::AddSymbol

IDebugSymbolGroup::AddSymbol

-description

The AddSymbol method adds a symbol to a symbol group.

-parameters

-param Name [in]

The symbol's name. Name is examined as an expression to determine the symbol's type. This expression can include pointer, array, and structure dereferencing (for example, *my_pointer, my_array[1], or my_struct.some_field).

-param Index [in, out]

The index of the entry in the symbol group. When you are calling AddSymbol or AddSymbolWide, Index should point to the index of the symbol that you want. Or, if Index points to DEBUG_ANY_ID, the symbol is appended to the end of the list.

When this method returns, Index points to the actual index of the symbol. The index of a symbol is an identification number. The index ranges from zero through the number of symbols in the symbol group minus one.

-returns

Return code Description
S_OK
The method was successful.
 

This method can also return error values. For more information, see Return Values.

-remarks

The symbol name in Name is evaluated by the C++ expression evaluator and can contain any C++ expression (for example, x+y).

If the index that you want is less than the size of the symbol group, the new symbol is added at the desired index. If the desired index is larger than the size of the symbol group, the new symbol is added to the end of the list (as in the case of DEBUG_ANY_ID).

For more information about symbol groups, see Scopes and Symbol Groups.

-see-also

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2

RemoveSymbolByIndex

RemoveSymbolByName