Compartilhar via

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

  • Artigo

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

Sintaxe

HRESULT GetSourceFileLineOffsetsWide(
  [in]            PCWSTR   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.

Comentários

Para obter mais informações sobre como usar o caminho de origem, consulte Usando arquivos de origem.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols3