Process32First

9/8/2008

Essa função recupera informações sobre o primeiro processo encontrado em um instantâneo sistema.

Syntax

BOOL WINAPI Process32First(
  HANDLE hSnapshot,
  LPPROCESSENTRY32 lppe
);

Parameters

• hSnapshot
  [no] Identificador para o instantâneo retornado de uma chamar anterior para a função CreateToolhelp32Snapshot.

• lppe
  [out] Ponteiro para uma estrutura PROCESSENTRY32.

Return Value

TRUE indica que a primeira entrada da lista a processo tem sido copiada para a reserva. FALSE indica falha. O valor de erro ERROR_NO_MORE_FILES, retornado pelo GetLastError, indica que nenhum processo existe ou o instantâneo não contém informações processo.

Remarks

O aplicativo chamado deve definir a dwSize membro de PROCESSENTRY32 Para o tamanho, em bytes, da estrutura.

Process32First As alterações dwSize Para o número de bytes gravados a estrutura. Esse número nunca é maior do que o valor inicial de dwSize, mas ele pode ser menor. Se o valor é menor, não dependem de valores dos membros cujos deslocamentos são maiores que esse valor. Para recuperar informações sobre outros processos registrados no mesmo instantâneo, use a função Process32Next.

Requirements

Header	tlhelp32.h
Library	toolhelp.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

ToolHelp Functions
CreateToolhelp32Snapshot
Process32Next
PROCESSENTRY32