CreateSymbolGroup

The CreateSymbolGroup and CreateSymbolGroup2 methods create a new symbol group.

HRESULT
  IDebugSymbols::CreateSymbolGroup(
    OUT IDebugSymbolGroup * *  Group
    );

HRESULT
  IDebugSymbols3::CreateSymbolGroup2(
    OUT IDebugSymbolGroup2 * *  Group
    );

Parameters

Group

Receives an interface pointer for the new IDebugSymbolGroup object.

Return Value

S_OK

The method was successful.

This method may also return error values. See Return Values for more details.

Interface Version

CreateSymbolGroup is available in all versions of IDebugSymbols. CreateSymbolGroup2 is available in IDebugSymbols3 and later versions.

Comments

The newly created symbol group is empty; it does not contain any symbols. Symbols may be added to the symbol group using IDebugSymbolGroup::AddSymbol.

References to the returned object are managed like other COM objects, using the IUnknown::AddRef and IUnknown::Release methods. In particular, the IUnknown::Release method must be called when the returned object is no longer needed. See COM Interfaces for more information about using COM interfaces in the Debugger Engine API.

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

Requirements

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

See Also

IDebugSymbolGroup, IDebugSymbolGroup::AddSymbol