Método IDebugSymbols3::GetLineByOffset (dbgeng.h)
O método GetLineByOffset retorna o nome do arquivo de origem e o número de linha no arquivo de origem de uma instrução no destino.
Sintaxe
HRESULT GetLineByOffset(
[in] ULONG64 Offset,
[out, optional] PULONG Line,
[out, optional] PSTR FileBuffer,
[in] ULONG FileBufferSize,
[out, optional] PULONG FileSize,
[out, optional] PULONG64 Displacement
);
Parâmetros
[in] Offset
Especifica o local no espaço de endereço virtual do destino da instrução para a qual retornar o arquivo de origem e o número da linha.
[out, optional] Line
Recebe o número de linha no arquivo de origem da instrução especificada por Offset. Se de Linha for NULL, essas informações não serão retornadas.
[out, optional] FileBuffer
Recebe o nome do arquivo que contém a instrução especificada por Offset. Se filebuffer for NULL, essas informações não serão retornadas.
[in] FileBufferSize
Especifica o tamanho, em caracteres, do buffer FileBuffer.
[out, optional] FileSize
Especifica o tamanho, em caracteres, do nome do arquivo de origem. Se FileSize estiver NULL, essas informações não serão retornadas.
[out, optional] Displacement
Recebe a diferença entre o local especificado em deslocamento e o local da primeira instrução da linha retornada. Se de Deslocamento for NULL, essas informações não serão retornadas.
Valor de retorno
Esse método também pode retornar outros 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 buffer não era grande o suficiente para manter o nome do arquivo de origem e o nome foi truncado. |
Observações
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) |