UpdateDebugInfoFileEx-Funktion (imagehlp.h)

Artikel
08/24/2023

Verwendet die angegebenen erweiterten Informationen, um die entsprechenden Felder in der Symboldatei zu aktualisieren.

Hinweis Diese Funktion funktioniert mit DBG-Dateien, nicht mit PDB-Dateien.

Syntax

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

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.

[in] OldCheckSum

Der ursprüngliche Prüfsummenwert. Wenn dieser Wert nicht mit der Prüfsumme übereinstimmt, die im zugeordneten Bild vorhanden ist, enthalten die Flags in der Symboldatei IMAGE_SEPARATE_DEBUG_MISMATCH, und der letzte Fehlerwert wird auf ERROR_INVALID_DATA festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

Hinweise

Die Funktion UpdateDebugInfoFileEx ü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

Weitere Informationen

IMAGE_NT_HEADERS

ImageHlp-Funktionen

Freigeben über