Método IDebugSymbols::GetScopeSymbolGroup (dbgeng.h)
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 |
---|---|
|
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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | dbgeng.h (inclua Dbgeng.h) |