Freigeben über


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

Weitere Informationen

ImageHlp-Funktionen

ImageUnload

LOADED_IMAGE