Método IDebugSymbols2::GetSourceFileLineOffsets (dbgeng.h)
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 este 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 para i+1de linha. Se nenhuma informação de símbolo estiver disponível para uma linha, a entrada correspondente no do 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 de do Buffer de pode conter.
[out, optional] FileLines
Recebe o número de linhas no arquivo de origem especificado por File.
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. |
|
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 de do buffer e alguns dos resultados foram descartados. |
Observações
Para obter mais informações sobre como usar o caminho de origem, consulte Usando arquivos de origem.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |