Funzione UpdateDebugInfoFile (imagehlp.h)

Articolo
02/29/2024

Usa le informazioni specificate per aggiornare i campi corrispondenti nel file di simboli.

Nota Questa funzione funziona con i file con estensione dbg, non con estensione pdb.

Questa funzione è stata sostituita dalla funzione UpdateDebugInfoFileEx . Usare UpdateDebugInfoFileEx per verificare il valore checksum.

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

Vedi anche

IMAGE_NT_HEADERS

Funzioni ImageHlp

UpdateDebugInfoFileEx

Share via