Condividi tramite


Funzione Process32First (tlhelp32.h)

Recupera informazioni sul primo processo rilevato in uno snapshot di sistema.

Sintassi

BOOL Process32First(
  [in]      HANDLE           hSnapshot,
  [in, out] LPPROCESSENTRY32 lppe
);

Parametri

[in] hSnapshot

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

[in, out] lppe

Puntatore a una struttura PROCESSENTRY32 . Contiene informazioni sul processo, ad esempio il nome del file eseguibile, l'identificatore del processo e l'identificatore di processo del processo padre.

Valore restituito

Restituisce TRUE se la prima voce dell'elenco di processi è 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 processi o lo snapshot non contiene informazioni sul processo.

Commenti

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

Per recuperare informazioni su altri processi registrati nello stesso snapshot, usare la funzione Process32Next .

Esempio

Per un esempio, vedere Creazione di uno snapshot e visualizzazione di processi.

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

Vedere anche

CreateToolhelp32Snapshot

PROCESSENTRY32

Procedura a piedi

Process32Next

Funzioni della Guida degli strumenti