IDebugSymbols3::CreateSymbolGroup method (dbgeng.h)

The CreateSymbolGroup method creates a new symbol group.

Syntax

HRESULT CreateSymbolGroup(
  [out] PDEBUG_SYMBOL_GROUP *Group
);

Parameters

[out] Group

Receives an interface pointer for the new IDebugSymbolGroup object.

Return value

Return code Description
S_OK
The method was successful.
 

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

Remarks

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 Using Client Objects for more information about using COM interfaces in the Debugger Engine API.

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

Requirements

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

See also

IDebugSymbolGroup

IDebugSymbolGroup::AddSymbol

IDebugSymbols

IDebugSymbols2

IDebugSymbols3