Metodo IDebugSymbols3::GetSourceFileLineOffsets (dbgeng.h)

Articolo
08/07/2023

Il metodo GetSourceFileLineOffsets esegue il mapping di ogni riga di un file di origine a una posizione 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 percorsi 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 i percorsi 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 viene 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 altri dettagli, 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.