Freigeben über


BindImage-Funktion (imagehlp.h)

Berechnet die virtuelle Adresse jeder importierten Funktion.

Diese Funktion wurde von der BindImageEx-Funktion abgelöst. Verwenden Sie BindImageEx, um eine status Routine oder Flags zum Steuern der Bildbindung bereitzustellen.

Syntax

BOOL IMAGEAPI BindImage(
  [in] PCSTR ImageName,
  [in] PCSTR DllPath,
  [in] PCSTR SymbolPath
);

Parameter

[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.

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

Ein Aufruf von BindImage entspricht dem folgenden Aufruf: BindImageEx( 0, ImageName, DllPath, SymbolPath, NULL );

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

BindImageEx

ImageHlp-Funktionen