Método IDebugSymbols2::CreateSymbolGroup (dbgeng.h)

Artigo
02/23/2024

O método CreateSymbolGroup cria um novo grupo de símbolos.

Sintaxe

HRESULT CreateSymbolGroup(
  [out] PDEBUG_SYMBOL_GROUP *Group
);

Parâmetros

[out] Group

Recebe um ponteiro de interface para o novo objeto IDebugSymbolGroup .

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

O grupo de símbolos recém-criado está vazio; ele não contém nenhum símbolo. Os símbolos podem ser adicionados ao grupo de símbolos usando IDebugSymbolGroup::AddSymbol.

As referências ao objeto retornado são gerenciadas como outros objetos COM, usando os métodos IUnknown::AddRef e IUnknown::Release . Em particular, o método IUnknown::Release deve ser chamado quando o objeto retornado não é mais necessário. Consulte Usando objetos de cliente para obter mais informações sobre como usar interfaces COM na API do Mecanismo de Depurador.

Para obter mais informações sobre grupos de símbolos, consulte Escopos e grupos de símbolos.