Metodo IDebugAdvanced3::GetSourceFileInformation (dbgeng.h)

Articolo
08/07/2023

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. Il parametro Which 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 buffer come matrice di byte. Le dimensioni di questo token sono un riflesso 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 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 Which specifica il modulo il cui token di simbolo è richiesto. Indipendentemente dal valore di Which, 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 Which. Se Buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

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

[out, optional] InfoSize

Specifica le dimensioni in byte delle informazioni restituite al 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 è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, le informazioni non rientrano nel buffer buffer , quindi le informazioni o il nome sono stati troncati.

Commenti

Per altre informazioni sui file di origine, vedere Uso dei file di origine.

Requisiti

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

Vedi anche

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3