Funzione UpdateDebugInfoFile (imagehlp.h)
Usa le informazioni specificate per aggiornare i campi corrispondenti nel file di simboli.
Sintassi
BOOL IMAGEAPI UpdateDebugInfoFile(
[in] PCSTR ImageFileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in] PIMAGE_NT_HEADERS32 NtHeaders
);
Parametri
[in] ImageFileName
Nome dell'immagine ora non aggiornata rispetto al relativo file di simbolo.
[in] SymbolPath
Percorso in cui cercare il file di simboli.
[out] DebugFilePath
Puntatore a un buffer che riceve il nome del file di simbolo aggiornato.
[in] NtHeaders
Puntatore a una struttura IMAGE_NT_HEADERS che specifica le nuove informazioni sull'intestazione.
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
La funzione UpdateDebugInfoFile accetta le informazioni archiviate nella struttura IMAGE_NT_HEADERS e aggiorna i campi corrispondenti nel file di simboli. Ogni volta che viene modificato un file di immagine, questa funzione deve essere chiamata per mantenere sincronizzati i numeri. In particolare, ogni volta che viene modificato un checksum di un'immagine, il file di simboli deve essere aggiornato in modo che corrisponda.
Tutte le funzioni ImageHlp, 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imagehlp.h |
| Libreria | Imagehlp.lib |
| DLL | Imagehlp.dll |