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

Vedi anche

Funzioni DbgHelp

SymSrvStoreSupplement