IDebugSymbolGroup2::ExpandSymbol method (dbgeng.h)

Article
02/22/2024

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

Syntax

HRESULT ExpandSymbol(
  [in] ULONG Index,
  [in] BOOL  Expand
);

Parameters

[in] 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.

[in] 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

Return code	Description
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 can also return other error values. For more information, see Return Values.

Remarks

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

Requirements

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