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

Artículo
02/23/2024

El método GetLineByOffset devuelve el nombre de archivo de origen y el número de línea dentro del archivo de origen de una instrucción en el destino.

Sintaxis

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 la ubicación en el espacio de direcciones virtuales del destino de la instrucción para la que se va a devolver el archivo de origen y el número de línea.

[out, optional] Line

Recibe el número de línea dentro del archivo de origen de la instrucción especificada por Offset. Si Line es NULL, esta información no se devuelve.

[out, optional] FileBuffer

Recibe el nombre de archivo del archivo que contiene la instrucción especificada por Offset. Si FileBuffer es NULL, esta información no se devuelve.

[in] FileBufferSize

Especifica el tamaño, en caracteres, del búfer FileBuffer .

[out, optional] FileSize

Especifica el tamaño, en caracteres, del nombre de archivo de origen. Si FileSize es NULL, esta información no se devuelve.

[out, optional] Displacement

Recibe la diferencia entre la ubicación especificada en Offset y la ubicación de la primera instrucción de la línea devuelta. Si El desplazamiento es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el búfer no era lo suficientemente grande como para contener el nombre del archivo de origen y el nombre se truncaba.