Compartilhar via


Função Module32First (tlhelp32.h)

Recupera informações sobre o primeiro módulo associado a um processo.

Sintaxe

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

Parâmetros

[in] hSnapshot

Um identificador para o instantâneo retornado de uma chamada anterior para a função CreateToolhelp32Snapshot.

[in, out] lpme

Um ponteiro para uma estrutura MODULEENTRY32 .

Retornar valor

Retornará TRUE se a primeira entrada da lista de módulos tiver sido copiada para o buffer ou FALSE caso contrário. O valor de erro ERROR_NO_MORE_FILES será retornado pela função GetLastError se nenhum módulo existir ou o instantâneo não contiver informações de módulo.

Comentários

O aplicativo de chamada deve definir o membro dwSize de MODULEENTRY32 para o tamanho, em bytes, da estrutura.

Para recuperar informações sobre outros módulos associados ao processo especificado, use a função Module32Next .

Exemplos

Para obter um exemplo, consulte Atravessando a lista de módulos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tlhelp32.h
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CreateToolhelp32Snapshot

MODULEENTRY32

Módulo Caminhando

Module32Next

Funções de Ajuda da Ferramenta