Condividi tramite


Funzione Thread32First (tlhelp32.h)

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

Sintassi

BOOL Thread32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPTHREADENTRY32 lpte
);

Parametri

[in] hSnapshot

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

[in, out] lpte

Puntatore a una struttura THREADENTRY32 .

Valore restituito

Restituisce TRUE se la prima voce dell'elenco di thread è stata copiata nel buffer o FALSE in caso contrario. Il valore di errore ERROR_NO_MORE_FILES viene restituito dalla funzione GetLastError se non esiste alcun thread o lo snapshot non contiene informazioni sul thread.

Commenti

L'applicazione chiamante deve impostare il membro dwSize di THREADENTRY32 sulle dimensioni, in byte, della struttura. Thread32First imposta dwSize sul numero di byte scritti nella struttura. Questo valore non sarà mai maggiore del valore iniziale di dwSize, ma potrebbe essere più piccolo. Se il valore è minore, non fare affidamento sui valori di tutti i membri i cui offset sono maggiori di questo valore.

Per recuperare informazioni su altri thread registrati nello stesso snapshot, usare la funzione Thread32Next .

Esempio

Per un esempio, vedere Attraversamento dell'elenco di thread.

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

THREADENTRY32

Thread Walking

Thread32Avanti

Funzioni della Guida degli strumenti