Funzione Module32First (tlhelp32.h)

Articolo
03/02/2024

Recupera informazioni sul primo modulo associato a un processo.

Sintassi

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

Parametri

[in] hSnapshot

Handle per lo snapshot restituito da una chiamata precedente alla funzione CreateToolhelp32Snapshot .

[in, out] lpme

Puntatore a una struttura MODULEENTRY32 .

Valore restituito

Restituisce TRUE se la prima voce dell'elenco di moduli è stata copiata nel buffer o false in caso contrario. Il valore di errore ERROR_NO_MORE_FILES viene restituito dalla funzione GetLastError se non esistono moduli o lo snapshot non contiene informazioni sul modulo.

Commenti

L'applicazione chiamante deve impostare il membro dwSize di MODULEENTRY32 sulle dimensioni, in byte, della struttura.

Per recuperare informazioni su altri moduli associati al processo specificato, usare la funzione Module32Next .

Esempio

Per un esempio, vedere Attraversamento dell'elenco di moduli.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tlhelp32.h
Libreria	Kernel32.lib
DLL	Kernel32.dll