Freigeben über


ResumeThread-Funktion (processthreadsapi.h)

Verringert die Anzahl der Unterbrechungen eines Threads. Wenn die Anzahl der Angehaltenen auf null erhöht wird, wird die Ausführung des Threads fortgesetzt.

Syntax

DWORD ResumeThread(
  [in] HANDLE hThread
);

Parameter

[in] hThread

Ein Handle für den neu zu startenden Thread.

Dieses Handle muss über das THREAD_SUSPEND_RESUME-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die vorherige Angehaltene Anzahl des Threads.

Wenn die Funktion fehlschlägt, ist der Rückgabewert (DWORD) -1. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die ResumeThread-Funktion überprüft die Anzahl der Unterbrechungen des Betreffthreads. Wenn die Anzahl der Unterbrechungen 0 ist, wird der Thread derzeit nicht angehalten. Andernfalls wird die Anzahl der Unterbrechungen des Betreffthreads verringert. Wenn der resultierende Wert 0 ist, wird die Ausführung des Betreffthreads fortgesetzt.

Wenn der Rückgabewert 0 ist, wurde der angegebene Thread nicht angehalten. Wenn der Rückgabewert 1 ist, wurde der angegebene Thread angehalten, aber neu gestartet. Wenn der Rückgabewert größer als 1 ist, wird der angegebene Thread weiterhin angehalten.

Beachten Sie, dass beim Melden von Debugereignissen alle Threads innerhalb des Berichterstellungsprozesses eingefroren werden. Von Debuggern wird erwartet, dass sie die Funktionen SuspendThread und ResumeThread verwenden, um den Satz von Threads einzuschränken, die innerhalb eines Prozesses ausgeführt werden können. Durch Das Anhalten aller Threads in einem Prozess mit Ausnahme des Threads, der ein Debugereignis meldet, ist es möglich, einen einzelnen Schritt in einem einzelnen Thread zu erstellen. Die anderen Threads werden nicht durch einen Fortsetzungsvorgang freigegeben, wenn sie angehalten werden.

Windows Phone 8.1: Diese Funktion wird für Windows Phone Store-Apps unter Windows Phone 8.1 und höher unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (einschließlich Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib; WindowsPhoneCore.lib unter Windows Phone 8.1
DLL Kernel32.dll; KernelBase.dll am Windows Phone 8.1

Weitere Informationen

OpenThread

Prozess- und Threadfunktionen

SuspendThread

Threadausführung angehalten

Threads