Metodo IDebugSymbols3::GetLineByOffset (dbgeng.h)

Articolo
02/23/2024

Il metodo GetLineByOffset restituisce il nome del file di origine e il numero di riga all'interno del file di origine di un'istruzione nella destinazione.

Sintassi

HRESULT GetLineByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PSTR     FileBuffer,
  [in]            ULONG    FileBufferSize,
  [out, optional] PULONG   FileSize,
  [out, optional] PULONG64 Displacement
);

Parametri

[in] Offset

Specifica il percorso nello spazio indirizzi virtuale della destinazione dell'istruzione per cui restituire il file di origine e il numero di riga.

[out, optional] Line

Riceve il numero di riga all'interno del file di origine dell'istruzione specificata da Offset. Se Line è NULL, queste informazioni non vengono restituite.

[out, optional] FileBuffer

Riceve il nome del file che contiene l'istruzione specificata da Offset. Se FileBuffer è NULL, queste informazioni non vengono restituite.

[in] FileBufferSize

Specifica le dimensioni, in caratteri, del buffer FileBuffer .

[out, optional] FileSize

Specifica le dimensioni, in caratteri, del nome file di origine. Se FileSize è NULL, queste informazioni non vengono restituite.

[out, optional] Displacement

Riceve la differenza tra la posizione specificata in Offset e la posizione della prima istruzione della riga restituita. Se lo spostamento è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire altri 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 buffer non era abbastanza grande per contenere il nome del file di origine e il nome è stato troncato.