ImageLoad-Funktion (imagehlp.h)
Verwaltet eine Liste der geladenen DLLs.
Syntax
PLOADED_IMAGE IMAGEAPI ImageLoad(
[in] PCSTR DllName,
[in] PCSTR DllPath
);
Parameter
[in] DllName
Der Name des Bildes.
[in] DllPath
Der Pfad, der zum Suchen des Bilds verwendet wird, wenn der angegebene Name nicht gefunden werden kann. Wenn NULL verwendet wird, gelten die Suchpfadregeln, die in der SearchPath-Funktion festgelegt sind.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf eine LOADED_IMAGE-Struktur .
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Die ImageLoad-Funktion wird verwendet, um eine Liste der geladenen DLLs zu verwalten. Wenn das Image bereits geladen wurde, wird die vorherige LOADED_IMAGE zurückgegeben. Andernfalls wird das neue Image der Liste hinzugefügt.
Die LOADED_IMAGE-Struktur muss von der ImageUnload-Funktion zugeordnet 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 |