Funzione SymSrvGetSupplement (dbghelp.h)
Recupera il file specificato dal supplemento per un archivio simboli.
Sintassi
PCSTR IMAGEAPI SymSrvGetSupplement(
[in] HANDLE hProcess,
[in, optional] PCSTR SymPath,
[in] PCSTR Node,
[in] PCSTR File
);
Parametri
[in] hProcess
Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .
[in, optional] SymPath
Percorso del simbolo. La funzione usa solo gli archivi di simboli descritti nella sintassi standard per gli archivi simboli. Tutti gli altri percorsi vengono ignorati. Se questo parametro è NULL, la funzione usa il percorso del simbolo impostato usando la funzione SymInitialize o SymSetSearchPath .
[in] Node
File di simboli associato al file supplementare.
[in] File
Nome del file.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è il percorso completo per il file supplementare.
Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
Per altre informazioni sui file supplementari, vedere SymSrvStoreSupplement.
Questa funzione restituisce un puntatore a un buffer che può essere riutilizzato da un'altra funzione. Assicurarsi quindi di copiare immediatamente i dati restituiti in un altro buffer.
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
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | dbghelp.h |
Libreria | Dbghelp.lib |
DLL | Dbghelp.dll |
Componente ridistribuibile | DbgHelp.dll 6.3 o versione successiva |