Metodo IDebugSymbols3::GetSourceEntriesByLineWide (dbgeng.h)

Articolo
02/06/2025

Il metodo GetSourceEntriesByLineWide esegue una query sulle informazioni sui simboli e restituisce i percorsi nella memoria della destinazione che corrispondono alle righe di un file di origine.

Sintassi

HRESULT GetSourceEntriesByLineWide(
  [in]            ULONG                      Line,
  [in]            PCWSTR                     File,
  [in]            ULONG                      Flags,
  [out, optional] PDEBUG_SYMBOL_SOURCE_ENTRY Entries,
  [in]            ULONG                      EntriesCount,
  [out, optional] PULONG                     EntriesAvail
);

Parametri

[in] Line

Specifica la riga nel file di origine per cui eseguire una query. Il numero della prima riga è 1.

[in] File

Specifica il file di origine. I simboli per ogni modulo nella destinazione vengono sottoposti a query per questo file.

[in] Flags

Specifica i flag di bit che controllano il comportamento di questo metodo. Flag può essere qualsiasi combinazione di valori della tabella seguente.

Valore	Descrizione
DEBUG_GSEL_NO_SYMBOL_LOADS	Il motore del debugger cercherà solo il file tra i moduli i cui simboli sono già stati caricati. I simboli per gli altri moduli non verranno caricati. Se questa opzione non è impostata, il motore del debugger caricherà i simboli per tutti i moduli finché non troverà il file specificato in File.
DEBUG_GSEL_ALLOW_LOWER	Includere tutte le righe in File prima di Riga nel risultato.
DEBUG_GSEL_ALLOW_HIGHER	Includere tutte le righe in File dopo Riga nel risultato.
DEBUG_GSEL_NEAREST_ONLY	Restituisce al massimo un risultato. Se vengono impostati DEBUG_GSEL_ALLOW_LOWER o DEBUG_GSEL_ALLOW_HIGHER, il risultato restituito sarà relativo a una riga vicina a riga, ma non può essere riga se non sono presenti informazioni sui simboli per tale riga.

Per usare il set predefinito di flag, impostare Flag su DEBUG_GSEL_DEFAULT. Tutti i flag nella tabella precedente sono disattivati.

[out, optional] Entries

Riceve i percorsi nella memoria della destinazione che corrispondono alle righe di origine sottoposte a query. Ogni voce di questa matrice è di tipo DEBUG_SYMBOL_SOURCE_ENTRY e contiene il numero di riga di origine insieme a una posizione nella memoria della destinazione.

[in] EntriesCount

Specifica il numero di voci nella voci matrice.

[out, optional] EntriesAvail

Riceve il numero di posizioni che corrispondono alla query trovata nella memoria della destinazione.

Valore restituito

Questi metodi possono anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, le voci matrice non erano sufficienti per contenere tutti i risultati corrispondenti alla query e i risultati aggiuntivi sono stati eliminati.
E_NOINTERFACE	La query non ha restituito risultati. Ciò include il caso in cui le informazioni sul simbolo non erano disponibili per il file specificato.

Osservazioni

Questi metodi possono essere usati dalle applicazioni del debugger per recuperare i percorsi nella memoria della destinazione per l'impostazione di punti di interruzione o la corrispondenza del codice sorgente con istruzioni disassemblate. Ad esempio, l'impostazione dei flag DEBUG_GSEL_ALLOW_HIGHER e DEBUG_GSEL_NEAREST_ONLY restituirà il percorso di memoria della destinazione per la prima parte di codice a partire dalla riga specificata.

Per altre informazioni sui file di origine, vedere Using Source Files.