RemoveSymbolByName

The RemoveSymbolByName and RemoveSymbolByNameWide methods remove the specified symbol from a symbol group.

HRESULT
  IDebugSymbolGroup::RemoveSymbolByName(
    IN PCSTR  Name
    );

HRESULT
  IDebugSymbolGroup2::RemoveSymbolByNameWide(
    IN PCWSTR  Name
    );

#ifdef UNICODE
#define RemoveSymbolByNameT RemoveSymbolByNameWide
#else
#define RemoveSymbolByNameT RemoveSymbolByName
#endif

Parameters

Name

The name of the symbol to remove from the symbol group.

Return Value

RemoveSymbolByName and RemoveSymbolByNameWide might return one of the following values:

S_OK

The method was successful.

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

Comments

When a symbol is removed, the indexes of the symbols that remain in the symbol group might change.

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

Requirements

Versions: RemoveSymbolByName is available in all versions of IDebugSymbolGroup. RemoveSymbolByNameWide is available in IDebugSymbolGroup2 and later versions.

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

See Also

AddSymbol, GetSymbolName, RemoveSymbolByIndex