Método IDebugSymbols3::GetLineByOffset (dbgeng.h)
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, no se devuelve esta información.
[out, optional] FileBuffer
Recibe el nombre de archivo del archivo que contiene la instrucción especificada por Offset. Si FileBuffer es NULL, no se devuelve esta información.
[in] FileBufferSize
Especifica el tamaño, en caracteres, del búfer de FileBuffer.
[out, optional] FileSize
Especifica el tamaño, en caracteres, del nombre de archivo de origen. Si FileSize es NULL, no se devuelve esta información.
[out, optional] Displacement
Recibe la diferencia entre la ubicación especificada en desplazamiento y la ubicación de la primera instrucción de la línea devuelta. Si de desplazamiento es NULL, no se devuelve esta información.
Valor devuelto
Este método también puede devolver otros valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El método se realizó 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. |
Observaciones
Para obtener más información sobre los archivos de origen, vea Using Source Files.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |