Share via

Funzione UpdateDebugInfoFileEx (imagehlp.h)

  • Articolo

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

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

Sintassi

BOOL IMAGEAPI UpdateDebugInfoFileEx(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders,
  [in]  DWORD               OldCheckSum
);

Parametri

[in] ImageFileName

Nome dell'immagine non aggiornata rispetto al relativo file di simboli.

[in] SymbolPath

Percorso in cui cercare il file di simboli.

[out] DebugFilePath

Puntatore a un buffer che riceve il nome del file di simboli aggiornato.

[in] NtHeaders

Puntatore a una struttura IMAGE_NT_HEADERS che specifica le nuove informazioni di intestazione.

[in] OldCheckSum

Valore del checksum originale. Se questo valore non corrisponde al checksum presente nell'immagine mappata, i flag nel file di simboli contengono IMAGE_SEPARATE_DEBUG_MISMATCH e l'ultimo valore di errore viene impostato su ERROR_INVALID_DATA.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE.

Commenti

La funzione UpdateDebugInfoFileEx 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. 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.

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