Debugging Tools for Windows

ExpandSymbol

The ExpandSymbol method adds or removes the children of a symbol from a symbol group.

HRESULT
  ExpandSymbol(
    IN ULONG  Index,
    IN BOOL  Expand
    );

Parameters

Index
The index of the symbol whose children will be added or removed. 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.
Expand
A Boolean value that specifies whether to add or remove the symbols children from the symbol group. If Expand is true, the children are added. If Expand is false, the children are removed.

Return Value

ExpandSymbol might return one of the following values:

S_OK
The method was successful.
S_FALSE
The symbol has no children to add.
E_INVALIDARG
The depth of the symbol is DEBUG_SYMBOL_EXPANSION_LEVEL_MASK, which is the maximum depth. This depth prevented the specified symbol's children from being added to this symbol group.

This method might also return error values. For more information about possible return values, see Return Values.

Comments

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

Requirements

Versions: Available in all versions of IDebugSymbolGroup.

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetNumberSymbols

Build machine: CAPEBUILD