Método IDebugSymbols3::GetScopeSymbolGroup (dbgeng.h)

Artigo
02/26/2024

O método GetScopeSymbolGroup retorna um grupo de símbolos que contém os símbolos no escopo do destino atual.

Sintaxe

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *Symbols
);

Parâmetros

[in] Flags

Especifica um conjunto de bits usado para determinar quais símbolos incluir no grupo de símbolos. Para incluir todos os símbolos, defina Sinalizadores como DEBUG_SCOPE_GROUP_ALL. Os sinalizadores de bit a seguir determinam quais símbolos estão incluídos.

Sinalizador	Descrição
DEBUG_SCOPE_GROUP_ARGUMENTS	Inclua os argumentos de função para o escopo atual.
DEBUG_SCOPE_GROUP_LOCALS	Inclua as variáveis locais para o escopo atual.

[in, optional] Update

Especifica um grupo de símbolos criado anteriormente que será atualizado para refletir o escopo atual. Se Update for NULL, um novo objeto de interface de grupo de símbolos será criado.

[out] Symbols

Recebe o objeto de interface do grupo de símbolos para o escopo atual. Para obter detalhes sobre essa interface, consulte IDebugSymbolGroup

Retornar valor

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

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

Comentários

O parâmetro Update permite atualizações eficientes ao percorrer o código. Em vez de criar e preencher um novo grupo de símbolos, o grupo de símbolos antigo pode ser atualizado.

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