Método IDebugSymbols::GetSourceFileLineOffsets (dbgeng.h)

Artigo
02/23/2024

O método GetSourceFileLineOffsets mapeia cada linha em um arquivo de origem para um local na memória do destino.

Sintaxe

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

Parâmetros

[in] File

Especifica o nome do arquivo cujas linhas serão transformadas em locais na memória do destino. Os símbolos de cada módulo no destino são consultados para esse arquivo. Se o arquivo não estiver localizado, o caminho será removido e os símbolos serão consultados novamente.

[out, optional] Buffer

Recebe os locais na memória do destino que correspondem às linhas do código-fonte. A primeira entrada retornada a essa matriz corresponde à primeira linha do arquivo, de modo que Buffer[i] contém o local da linha i+1. Se nenhuma informação de símbolo estiver disponível para uma linha, a entrada correspondente em Buffer será definida como DEBUG_INVALID_OFFSET. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferLines

Especifica o número de objetos PULONG64 que a matriz buffer pode conter.

[out, optional] FileLines

Recebe o número de linhas no arquivo de origem especificado pelo Arquivo.

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.
S_FALSE	O método foi bem-sucedido. No entanto, o número de linhas no arquivo de origem excedeu o número de entradas na matriz buffer e alguns dos resultados foram descartados.