Compartir a través de


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

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 Búfer se establece en DEBUG_INVALID_OFFSET. Si de búfer 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 Archivo.

Valor devuelto

Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.

Código devuelto Descripción
S_OK
El método se realizó correctamente.
S_FALSE
El método se realizó correctamente. Sin embargo, el número de líneas del archivo de origen superó el número de entradas de la matriz de Buffer y algunos de los resultados se descartaron.

Observaciones

Para obtener más información sobre el uso de la ruta de acceso de origen, vea Using Source Files.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3