MapAndLoad-Funktion (imagehlp.h)

Ordnet ein Bild zu und überlädt Daten aus der zugeordneten Datei vorab.

Syntax

BOOL IMAGEAPI MapAndLoad(
  [in]  PCSTR         ImageName,
  [in]  PCSTR         DllPath,
  [out] PLOADED_IMAGE LoadedImage,
  [in]  BOOL          DotDll,
  [in]  BOOL          ReadOnly
);

Parameter

[in] ImageName

Der Dateiname des Images (ausführbare Datei oder DLL), das geladen wird.

[in] DllPath

Der Pfad, der zum Suchen des Bilds verwendet wird, wenn der angegebene Name nicht gefunden werden kann. Wenn dieser Parameter NULL ist, gelten die Suchpfadregeln, die mithilfe der SearchPath-Funktion festgelegt werden.

[out] LoadedImage

Ein Zeiger auf eine LOADED_IMAGE Struktur, die Informationen zum Bild empfängt, nachdem es geladen wurde.

[in] DotDll

Die Standarderweiterung, die verwendet werden soll, wenn der Imagename keine Dateinamenerweiterung enthält. Wenn der Wert TRUE ist, wird eine .DLL-Erweiterung verwendet. Wenn der Wert FALSE ist, wird eine .EXE-Erweiterung verwendet.

[in] ReadOnly

Der Zugriffsmodus. Wenn dieser Wert TRUE ist, wird die Datei nur für Den Lesezugriff zugeordnet. Wenn der Wert FALSE ist, wird die Datei für lese- und schreibzugriff zugeordnet.

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 MapAndLoad-Funktion ordnet ein Bild zu und überlädt Daten aus der zugeordneten Datei. Die entsprechende Funktion UnMapAndLoad muss verwendet werden, um die Zuordnung aller Ressourcen zu beheben, die von der MapAndLoad-Funktion zugewiesen werden.

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

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

LOADED_IMAGE

UnMapAndLoad