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

O método GetLineByOffsetWide 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 GetLineByOffsetWide(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PWSTR    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
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 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)

Consulte também

GetOffsetByLine

IDebugSymbols3