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

Artículo
02/23/2024

El método GetSourceFileLineOffsets asigna cada línea de un archivo de origen a una ubicación en la memoria del destino.

Sintaxis

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

Parámetros

[in] File

Especifica el nombre del archivo cuyas líneas se convertirán en ubicaciones en la memoria del destino. Los símbolos de cada módulo del destino se consultan para este archivo. Si el archivo no se encuentra, se quita la ruta de acceso y se vuelven a consultar los símbolos.

[out, optional] Buffer

Recibe las ubicaciones de la memoria del destino que corresponden a las líneas del código fuente. La primera entrada devuelta a esta matriz corresponde a la primera línea del archivo, de modo que Buffer[i] contenga la ubicación de la línea i+1. Si no hay información de símbolos disponible para una línea, la entrada correspondiente en Buffer se establece en DEBUG_INVALID_OFFSET. Si Buffer es NULL, no se devuelve esta información.

[in] BufferLines

Especifica el número de objetos PULONG64 que puede contener la matriz buffer .

[out, optional] FileLines

Recibe el número de líneas del archivo de origen especificado por File.

Valor devuelto

Este método también puede devolver 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 número de líneas del archivo de origen superó el número de entradas de la matriz buffer y se descartaron algunos de los resultados.