ImagehlpApiVersionEx-Funktion (dbghelp.h)

Artikel
08/23/2023

Ändert die Versionsinformationen der bibliothek, die von der Anwendung verwendet wird.

Syntax

LPAPI_VERSION IMAGEAPI ImagehlpApiVersionEx(
  [in] LPAPI_VERSION AppVersion
);

Parameter

[in] AppVersion

Ein Zeiger auf eine API_VERSION-Struktur , die gültige Versionsinformationen für Ihre Anwendung enthält.

Rückgabewert

Der Rückgabewert ist ein Zeiger auf eine API_VERSION-Struktur .

Hinweise

Verwenden Sie die ImagehlpApiVersionEx-Funktion , um die Version der Bibliothek anzugeben, mit der die Anwendung erstellt wurde. Die Bibliothek verwendet diese Informationen, um die Kompatibilität sicherzustellen. Erwägen Sie z. B. das Durchlaufen von Kernelmodus-Rückrufstapelframes (Benutzer und GDI sind im Kernelmodus vorhanden). Wenn Sie ImagehlpApiVersionEx aufrufen, um das Revisionselement auf Version 4 oder höher festzulegen, wird die StackWalk64-Funktion über einen Rückrufstapelframe fortgesetzt. Andernfalls wird StackWalk64 beim Kernelübergang beendet, wenn Sie Revision auf eine frühere Version als 4 festlegen.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. 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.