Funzione ResumeThread (processthreadsapi.h)
Decrementa il numero di sospensioni di un thread. Quando il conteggio delle sospensioni viene decrementato su zero, l'esecuzione del thread viene ripresa.
Sintassi
DWORD ResumeThread(
[in] HANDLE hThread
);
Parametri
[in] hThread
Handle per il thread da riavviare.
Questo handle deve avere il diritto di accesso THREAD_SUSPEND_RESUME. Per altre informazioni, vedere Thread Security and Access Rights.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è il numero di sospensioni precedente del thread.
Se la funzione ha esito negativo, il valore restituito è (DWORD) -1. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
La funzione ResumeThread controlla il numero di sospendi del thread soggetto. Se il conteggio delle sospensioni è zero, il thread non è attualmente sospeso. In caso contrario, il conteggio di sospensione del thread dell'oggetto viene decrementato. Se il valore risultante è zero, viene ripresa l'esecuzione del thread del soggetto.
Se il valore restituito è zero, il thread specificato non è stato sospeso. Se il valore restituito è 1, il thread specificato è stato sospeso ma è stato riavviato. Se il valore restituito è maggiore di 1, il thread specificato viene comunque sospeso.
Si noti che durante la creazione di report sugli eventi di debug, tutti i thread all'interno del processo di creazione report sono bloccati. È previsto che i debugger usino SuspendThread e funzioni ResumeThread per limitare il set di thread che possono essere eseguiti all'interno di un processo. Sospendendo tutti i thread in un processo, ad eccezione di quello che segnala un evento di debug, è possibile "eseguire un singolo passaggio" in un singolo thread. Gli altri thread non vengono rilasciati da un'operazione di continuazione se vengono sospesi.
Windows Phone 8.1: Questa funzione è supportata per le app di Windows Phone Store in Windows Phone 8.1 e versioni successive.
windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [app desktop | App UWP] |
| server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| piattaforma di destinazione | Finestre |
| intestazione | processthreadsapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| libreria | Kernel32.lib; WindowsPhoneCore.lib in Windows Phone 8.1 |
| dll | Kernel32.dll; KernelBase.dll in Windows Phone 8.1 |