Função Process32First (tlhelp32.h)
Recupera informações sobre o primeiro processo encontrado em um sistema instantâneo.
Sintaxe
BOOL Process32First(
[in] HANDLE hSnapshot,
[in, out] LPPROCESSENTRY32 lppe
);
Parâmetros
[in] hSnapshot
Um identificador para o instantâneo retornado de uma chamada anterior para a função CreateToolhelp32Snapshot.
[in, out] lppe
Um ponteiro para uma estrutura PROCESSENTRY32 . Ele contém informações de processo, como o nome do arquivo executável, o identificador de processo e o identificador de processo do processo pai.
Retornar valor
Retornará TRUE se a primeira entrada da lista de processos 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 processo existir ou o instantâneo não contiver informações de processo.
Comentários
O aplicativo de chamada deve definir o membro dwSize de PROCESSENTRY32 para o tamanho, em bytes, da estrutura.
Para recuperar informações sobre outros processos registrados no mesmo instantâneo, use a função Process32Next.
Exemplos
Para obter um exemplo, consulte Tomando um instantâneo e exibindo processos.
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 |