Funzione SymSrvStoreSupplement (dbghelp.h)
Archivia un file nel supplemento specificato in un archivio simboli. Il file è in genere associato a un file nel server simboli.
Sintassi
PCSTR IMAGEAPI SymSrvStoreSupplement(
[in] HANDLE hProcess,
[in, optional] PCSTR SrvPath,
[in] PCSTR Node,
[in] PCSTR File,
[in] DWORD Flags
);
Parametri
[in] hProcess
Handle a un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .
[in, optional] SrvPath
Percorso dell'archivio simboli.
[in] Node
File di simboli associato al file supplementare.
[in] File
Nome del file.
[in] Flags
Se questo parametro è SYMSTOREOPT_COMPRESS, il file viene compresso nell'archivio simboli. Attualmente non sono presenti altri valori supportati.
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
Un uso importante per questa funzione consiste nell'archiviare i file delta. Per altre informazioni, vedere SymSrvDeltaName.
Questa funzione restituisce un puntatore a un buffer che può essere riutilizzato da un'altra funzione. Assicurarsi pertanto di copiare immediatamente i dati restituiti in un altro buffer.
Il server simboli archivia file supplementari con la stessa estensione in una directory comune. Ad esempio, Sup1.xml verrà archiviato nella directory seguente: SymPath\supplement\Node\xml.
L'amministratore di un archivio può impedire agli utenti di scrivere file supplementari creando un file di sola lettura nella radice dell'archivio denominato Supplemento. In alternativa, l'amministratore può creare la directory supplementare e usare gli elenchi di controllo di accesso per controllare l'accesso.
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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 versioni successive |