Compartir a través de

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

  • Artículo

La GetSourceEntriesByLine método consulta información de símbolos y devuelve ubicaciones en la memoria del destino que corresponden a líneas de un archivo de origen.

Sintaxis

HRESULT GetSourceEntriesByLine(
  [in]                    ULONG                      Line,
  [in]                    PCSTR                      File,
  [in]                    ULONG                      Flags,
  [out, writes, optional] PDEBUG_SYMBOL_SOURCE_ENTRY Entries,
  [in]                    ULONG                      EntriesCount,
  [out, optional]         PULONG                     EntriesAvail
);

Parámetros

[in] Line

Especifica la línea del archivo de origen para el que se va a consultar. El número de la primera línea es 1.

[in] File

Especifica el archivo de origen. Los símbolos de cada módulo del destino se consultan para este archivo.

[in] Flags

Especifica marcas de bits que controlan el comportamiento de este método. marcas puede ser cualquier combinación de valores de la tabla siguiente.

Valor Descripción
DEBUG_GSEL_NO_SYMBOL_LOADS El motor del depurador solo buscará el archivo entre los módulos cuyos símbolos ya se han cargado. Los símbolos de los demás módulos no se cargarán.

Si no se establece esta opción, el motor del depurador cargará los símbolos de todos los módulos hasta que encuentre el archivo especificado en Archivo.
DEBUG_GSEL_ALLOW_LOWER Incluya todas las líneas de Archivo antes de Line en el resultado.
DEBUG_GSEL_ALLOW_HIGHER Incluya todas las líneas de Archivo después de Line en el resultado.
DEBUG_GSEL_NEAREST_ONLY Solo devuelve como máximo un resultado. Si se establecen DEBUG_GSEL_ALLOW_LOWER o DEBUG_GSEL_ALLOW_HIGHER, el resultado devuelto será para una línea cercana a Line, pero no se puede Line si no hay información de símbolos para esa línea.

Para usar el conjunto predeterminado de marcas, establezca Marcas en DEBUG_GSEL_DEFAULT. Esto tiene desactivadas todas las marcas de la tabla anterior.

[out, writes, optional] Entries

Recibe las ubicaciones de la memoria del destino que corresponden a las líneas de origen consultadas. Cada entrada de esta matriz es de tipo DEBUG_SYMBOL_SOURCE_ENTRY y contiene el número de línea de origen junto con una ubicación en la memoria del destino.

[in] EntriesCount

Especifica el número de entradas de la matriz Entradas.

[out, optional] EntriesAvail

Recibe el número de ubicaciones que coinciden con la consulta encontrada en la memoria del destino.

Valor devuelto

Estos métodos también pueden 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, las entradas de matriz no eran lo suficientemente grandes como para contener todos los resultados que coinciden con la consulta y se descartaron los resultados adicionales.
E_NOINTERFACE
 La consulta no produjo ningún resultado. Esto incluye el caso en el que la información del símbolo no estaba disponible para el archivo especificado.

Observaciones

Las aplicaciones del depurador pueden usar estos métodos para capturar ubicaciones en la memoria del destino para establecer puntos de interrupción o hacer coincidir el código fuente con instrucciones desensambllados. Por ejemplo, establecer las marcas DEBUG_GSEL_ALLOW_HIGHER y DEBUG_GSEL_NEAREST_ONLY devolverá la ubicación de memoria del destino para el primer fragmento de código a partir de la línea especificada.

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)

Consulte también

DEBUG_SYMBOL_SOURCE_ENTRY

GetSourceFileLineOffsets

IDebugSymbols3