Metodo IDebugSymbols::GetSourceFileLineOffsets (dbgeng.h)

Articolo
02/25/2024

Il metodo GetSourceFileLineOffsets esegue il mapping di ogni riga in un file di origine a un percorso nella memoria della destinazione.

Sintassi

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

Parametri

[in] File

Specifica il nome del file le cui righe verranno trasformate in posizioni nella memoria della destinazione. I simboli per ogni modulo nella destinazione vengono sottoposti a query per questo file. Se il file non si trova, il percorso viene eliminato e i simboli vengono nuovamente sottoposti a query.

[out, optional] Buffer

Riceve le posizioni nella memoria della destinazione che corrispondono alle righe del codice sorgente. La prima voce restituita a questa matrice corrisponde alla prima riga del file, in modo che Buffer[i] contenga il percorso per la riga i+1. Se non sono disponibili informazioni sui simboli per una riga, la voce corrispondente in Buffer è impostata su DEBUG_INVALID_OFFSET. Se buffer è NULL, queste informazioni non vengono restituite.

[in] BufferLines

Specifica il numero di oggetti PULONG64 che la matrice buffer può contenere.

[out, optional] FileLines

Riceve il numero di righe nel file di origine specificato da File.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il numero di righe nel file di origine ha superato il numero di voci nella matrice buffer e alcuni dei risultati sono stati eliminati.