UpdateDebugInfoFile-Funktion (imagehlp.h)

  • Artikel

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

Hinweis Diese Funktion funktioniert mit DBG-Dateien, nicht mit PDB-Dateien.
 
Diese Funktion wurde durch die UpdateDebugInfoFileEx-Funktion ersetzt. Verwenden Sie UpdateDebugInfoFileEx , um den Prüfsummenwert zu überprüfen.

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

Weitere Informationen

IMAGE_NT_HEADERS

ImageHlp-Funktionen

UpdateDebugInfoFileEx