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

Artigo
02/06/2025

O método GetSourceEntriesByLineWide consulta informações de símbolo e retorna locais na memória do destino que correspondem a linhas em um arquivo de origem.

Sintaxe

HRESULT GetSourceEntriesByLineWide(
  [in]            ULONG                      Line,
  [in]            PCWSTR                     File,
  [in]            ULONG                      Flags,
  [out, optional] PDEBUG_SYMBOL_SOURCE_ENTRY Entries,
  [in]            ULONG                      EntriesCount,
  [out, optional] PULONG                     EntriesAvail
);

Parâmetros

[in] Line

Especifica a linha no arquivo de origem para a qual consultar. O número da primeira linha é 1.

[in] File

Especifica o arquivo de origem. Os símbolos de cada módulo no destino são consultados para este arquivo.

[in] Flags

Especifica sinalizadores de bits que controlam o comportamento desse método. Flags pode ser qualquer combinação de valores da tabela a seguir.

Valor	Descrição
DEBUG_GSEL_NO_SYMBOL_LOADS	O mecanismo de depurador só procurará o arquivo entre os módulos cujos símbolos já foram carregados. Os símbolos dos outros módulos não serão carregados. Se essa opção não estiver definida, o mecanismo de depurador carregará os símbolos de todos os módulos até encontrar o arquivo especificado no arquivo.
DEBUG_GSEL_ALLOW_LOWER	Inclua todas as linhas no de Arquivo antes de de Linha no resultado.
DEBUG_GSEL_ALLOW_HIGHER	Inclua todas as linhas no de Arquivo após de Linha no resultado.
DEBUG_GSEL_NEAREST_ONLY	Retornar somente no máximo um resultado. Se DEBUG_GSEL_ALLOW_LOWER ou DEBUG_GSEL_ALLOW_HIGHER estiverem definidos, o resultado retornado será para uma linha próxima a de Linha, mas não poderá ser de Linha se não houver informações de símbolo para essa linha.

Para usar o conjunto padrão de sinalizadores, defina Flags como DEBUG_GSEL_DEFAULT. Isso tem todos os sinalizadores da tabela anterior desativados.

[out, optional] Entries

Recebe os locais na memória do destino que correspondem às linhas de origem consultadas. Cada entrada nessa matriz é do tipo DEBUG_SYMBOL_SOURCE_ENTRY e contém o número da linha de origem junto com um local na memória do destino.

[in] EntriesCount

Especifica o número de entradas na matriz entradas de.

[out, optional] EntriesAvail

Recebe o número de locais que correspondem à consulta encontrada na memória do destino.

Valor de retorno

Esses métodos também podem retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, as entradas matriz não eram grandes o suficiente para manter todos os resultados correspondentes à consulta e os resultados extras foram descartados.
E_NOINTERFACE	A consulta não resultou em resultados. Isso inclui o caso em que as informações de símbolo não estavam disponíveis para o arquivo especificado.

Observações

Esses métodos podem ser usados por aplicativos de depurador para buscar locais na memória do destino para definir pontos de interrupção ou o código-fonte correspondente com instruções desmontadas. Por exemplo, definir os sinalizadores DEBUG_GSEL_ALLOW_HIGHER e DEBUG_GSEL_NEAREST_ONLY retornará o local de memória do destino para a primeira parte do código começando na linha especificada.

Para obter mais informações sobre arquivos de origem, consulte Usando arquivos de origem.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

DEBUG_SYMBOL_SOURCE_ENTRY

GetSourceFileLineOffsets

IDebugSymbols3

Partilhar via