UpdateDebugInfoFile-Funktion (imagehlp.h)
Verwendet die angegebenen Informationen, um die entsprechenden Felder in der Symboldatei zu aktualisieren.
Syntax
BOOL IMAGEAPI UpdateDebugInfoFile(
[in] PCSTR ImageFileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in] PIMAGE_NT_HEADERS32 NtHeaders
);
Parameter
[in] ImageFileName
Der Name des Bilds, das in Bezug auf die Symboldatei jetzt veraltet ist.
[in] SymbolPath
Der Pfad, in dem nach der Symboldatei gesucht werden soll.
[out] DebugFilePath
Ein Zeiger auf einen Puffer, der den Namen der aktualisierten Symboldatei empfängt.
[in] NtHeaders
Ein Zeiger auf eine IMAGE_NT_HEADERS-Struktur , die die neuen Headerinformationen angibt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Die Funktion UpdateDebugInfoFile übernimmt die in der IMAGE_NT_HEADERS-Struktur gespeicherten Informationen und aktualisiert die entsprechenden Felder in der Symboldatei. Jedes Mal, wenn eine Bilddatei geändert wird, sollte diese Funktion aufgerufen werden, um die Zahlen synchron zu halten. Insbesondere sollte die Symboldatei aktualisiert werden, wenn sich eine Bildprüfsumme ändert, damit sie übereinstimmt.
Alle ImageHlp-Funktionen, z. B. diese, sind single threaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imagehlp.h |
| Bibliothek | Imagehlp.lib |
| DLL | Imagehlp.dll |