Freigeben über


Module32First-Funktion (tlhelp32.h)

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

Siehe auch

CreateToolhelp32Snapshot

MODULEENTRY32

Module Walking

Modul32Weiter

Toolhilfefunktionen