Module32First-Funktion (tlhelp32.h)

Artikel
03/02/2024

Ruft Informationen zum ersten Modul ab, das einem Prozess zugeordnet ist.

Syntax

BOOL Module32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPMODULEENTRY32 lpme
);

Parameter

[in] hSnapshot

Ein Handle für die Momentaufnahme von einem vorherigen Aufruf der CreateToolhelp32Snapshot-Funktion zurückgegeben.

[in, out] lpme

Ein Zeiger auf eine MODULEENTRY32-Struktur .

Rückgabewert

Gibt TRUE zurück, wenn der erste Eintrag der Modulliste in den Puffer kopiert wurde, oder andernfalls FALSE . Der ERROR_NO_MORE_FILES Fehlerwert wird von der GetLastError-Funktion zurückgegeben, wenn keine Module vorhanden sind oder die Momentaufnahme keine Modulinformationen enthält.

Hinweise

Die aufrufende Anwendung muss den dwSize-Member von MODULEENTRY32 auf die Größe der Struktur in Bytes festlegen.

Verwenden Sie die Funktion Module32Next , um Informationen zu anderen Modulen abzurufen, die dem angegebenen Prozess zugeordnet sind.

Beispiele

Ein Beispiel finden Sie unter Durchlaufen der Modulliste.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tlhelp32.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll