Funzione ResumeThread (processthreadsapi.h)

Decrementa il conteggio di sospensione 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.For more information, see Thread Security and Access Rights.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il conteggio di sospensione precedente del thread.

Se la funzione ha esito negativo, il valore restituito è (DWORD) -1. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione ResumeThread controlla il conteggio delle sospensioni del thread soggetto. Se il conteggio delle sospensioni è zero, il thread non è attualmente sospeso. In caso contrario, il conteggio di sospensione del thread soggetto viene decrementato. Se il valore risultante è zero, viene ripresa l'esecuzione del thread 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 è ancora sospeso.

Si noti che durante la creazione di report degli eventi di debug, tutti i thread all'interno del processo di creazione report sono bloccati. È previsto che i debugger usino le funzioni SuspendThread e 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 Windows Phone app dello 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.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
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 Windows Phone 8.1

Vedi anche

OpenThread

Funzioni di processi e thread

SuspendThread

Sospensione dell'esecuzione del thread

Thread