Función Module32First (tlhelp32.h)

Artículo
03/02/2024

Recupera información sobre el primer módulo asociado a un proceso.

Sintaxis

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

Parámetros

[in] hSnapshot

Identificador de la instantánea devuelta desde una llamada anterior a la función CreateToolhelp32Snapshot .

[in, out] lpme

Puntero a una estructura MODULEENTRY32 .

Valor devuelto

Devuelve TRUE si la primera entrada de la lista de módulos se ha copiado en el búfer o FALSE en caso contrario. La función GetLastError devuelve el valor de error ERROR_NO_MORE_FILES si no existe ningún módulo o la instantánea no contiene información del módulo.

Comentarios

La aplicación que llama debe establecer el miembro dwSize de MODULEENTRY32 en el tamaño, en bytes, de la estructura.

Para recuperar información sobre otros módulos asociados al proceso especificado, use la función Module32Next .

Ejemplos

Para obtener un ejemplo, consulte Recorrido de la lista de módulos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tlhelp32.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll