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 |