Método IDebugSymbols2::GetLineByOffset (dbgeng.h)

Artigo
02/23/2024

O método GetLineByOffset retorna o nome do arquivo de origem e o número de linha dentro do 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 dentro do arquivo de origem da instrução especificada por Offset. Se Line 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 for 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 o Deslocamento for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar outros 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 buffer não era grande o suficiente para conter o nome do arquivo de origem e o nome foi truncado.