Funzione SymGetSourceFile (dbghelp.h)
Recupera il file di origine specificato dal server di origine.
Sintassi
BOOL IMAGEAPI SymGetSourceFile(
[in] HANDLE hProcess,
[in] ULONG64 Base,
[in, optional] PCSTR Params,
[in] PCSTR FileSpec,
[out] PSTR FilePath,
[in] DWORD Size
);
Parametri
[in] hProcess
Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .
[in] Base
Indirizzo di base del modulo.
[in, optional] Params
Questo parametro è inutilizzato.
[in] FileSpec
Nome del file di origine.
[out] FilePath
Puntatore a un buffer che riceve il percorso completo del file di origine.
[in] Size
Dimensioni del buffer FilePath , in caratteri.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE.
Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
Per controllare la directory che riceve i file di origine, usare la funzione SymSetHomeDirectory .
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.
Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | dbghelp.h |
| Libreria | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Componente ridistribuibile | DbgHelp.dll 6.2 o versione successiva |