BindImageEx-Funktion (imagehlp.h)

Artikel
08/24/2023

Berechnet die virtuelle Adresse jeder importierten Funktion.

Syntax

BOOL IMAGEAPI BindImageEx(
  [in] DWORD                    Flags,
  [in] PCSTR                    ImageName,
  [in] PCSTR                    DllPath,
  [in] PCSTR                    SymbolPath,
  [in] PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

Parameter

[in] Flags

Die Bindungsoptionen. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
BIND_ALL_IMAGES 0x00000004	Binden Sie alle Bilder in der Aufrufstruktur für diese Datei.
BIND_CACHE_IMPORT_DLLS 0x00000008	Verwerfen Sie zwischen Aufrufen keine DLL-Informationen im Cache. Dies verbessert die Leistung beim Binden einer großen Anzahl von Bildern.
BIND_NO_BOUND_IMPORTS 0x00000001	Generieren Sie keine neue Importadresstabelle.
BIND_NO_UPDATE 0x00000002	Nehmen Sie keine Änderungen an der Datei vor.

[in] ImageName

Der Name der datei, die gebunden werden soll. Dieser Wert kann ein Dateiname, ein Teilpfad oder ein vollständiger Pfad sein.

[in] DllPath

Der Stamm des zu verwendenden Suchpfads, wenn die durch den ImageName-Parameter angegebene Datei nicht geöffnet werden kann.

[in] SymbolPath

Der Stamm des Pfads zum Suchen nach der entsprechenden Symboldatei der Datei.

[in] StatusRoutine

Ein Zeiger auf eine status Routine. Die status Routine wird während des Fortschritts der Bildbindung aufgerufen. Weitere Informationen finden Sie unter StatusRoutine.

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

Der Prozess zum Binden eines Bilds besteht aus der Berechnung der virtuellen Adresse jeder importierten Funktion. Die berechnete virtuelle Adresse wird dann in der Importadressentabelle (Import Address Table, IAT) des importierenden Images gespeichert. Daher wird das Image viel schneller geladen, insbesondere wenn es viele DLLs verwendet, da das Systemladeprogramm nicht die Adresse jeder importierten Funktion berechnen muss.

Wenn eine entsprechende Symboldatei gefunden werden kann, werden der Zeitstempel und die Prüfsumme aktualisiert.

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


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

ImageHlp-Funktionen

StatusRoutine

Freigeben über