IDebugSymbols3::CreateSymbolGroup method (dbgeng.h)

Article
02/22/2024

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)