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 Flags como DEBUG_SCOPE_GROUP_ALL. Os sinalizadores de bit a seguir determinam quais símbolos estão incluídos.
| Bandeira | 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 Atualizar 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
Valor de retorno
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Observações
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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |