Metodo IDebugSymbols2::GetSourceFileLineOffsets (dbgeng.h)

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.

Commenti

Per altre informazioni sull'uso del percorso di origine, vedere Uso dei file di origine.

Requisiti

   
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Dbgeng.h)

Vedi anche

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3