Condividi tramite


Metodo IDebugSymbols3::GetSourceFileLineOffsetsWide (dbgeng.h)

Il metodo GetSourceFileLineOffsetsWide esegue il mapping di ogni riga di un file di origine a una posizione nella memoria della destinazione.

Sintassi

HRESULT GetSourceFileLineOffsetsWide(
  [in]            PCWSTR   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 sottoposti nuovamente 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 della 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 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, il numero di righe nel file di origine ha superato il numero di voci nella matrice Buffer e alcuni dei risultati sono stati eliminati.

Osservazioni

Per altre informazioni sull'uso del percorso di origine, vedere Using Source Files.

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione dbgeng.h (include Dbgeng.h)

Vedere anche

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols3