Metodo IDebugAdvanced2::GetSourceFileInformation (dbgeng.h)

Articolo
02/06/2025

Il metodo GetSourceFileInformation restituisce informazioni specificate su un file di origine.

Sintassi

HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parametri

[in] Which

Specifica la parte di informazioni da restituire. La Quale parametro può accettare uno dei valori nella tabella seguente.

DEBUG_SRCFILE_SYMBOL_TOKEN

Restituisce un token che rappresenta il file di origine specificato in un server di origine. Questo token può essere passato a FindSourceFileAndToken per recuperare informazioni sul file. Il token viene restituito al buffer di buffer come matrice di byte. Le dimensioni di questo token sono una reflection delle dimensioni del token SrcSrv.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Esegue una query su un server di origine per il comando per estrarre il file di origine dal controllo del codice sorgente. Sono inclusi il nome del file eseguibile e i relativi parametri della riga di comando. Il comando viene restituito al buffer buffer buffer come stringa Unicode.

[in] SourceFile

Specifica il file di origine le cui informazioni vengono richieste. Il file di origine viene cercato in tutti i server di origine nel percorso di origine.

[in] Arg64

Specifica un argomento a 64 bit. Valore di Quale specifica il modulo il cui token di simbolo è richiesto. Indipendentemente dal valore di Quale, Arg64 è una posizione all'interno dell'allocazione di memoria del modulo.

[in] Arg32

Specifica un argomento a 32 bit. Questo parametro è attualmente inutilizzato.

[out, optional] Buffer

Riceve le informazioni sul simbolo richieste. Il tipo dei dati restituiti dipende dal valore di Quale. Se buffer è null, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni in byte del buffer buffer di buffer. Se Buffer è NULL, BufferSize deve essere NULL.

[out, optional] InfoSize

Specifica le dimensioni in byte delle informazioni restituite al buffer buffer buffer. Questo parametro può essere null se i dati non sono necessari.

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, le informazioni non rientrano nel buffer buffer di buffer, quindi le informazioni o il nome sono stati troncati.

Osservazioni

Per altre informazioni sui file di origine, vedere Using Source Files.

Fabbisogno

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

Vedere anche

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Condividi tramite