Функция ResumeThread (processthreadsapi.h)
Уменьшает количество приостановки потока. При уменьшении количества приостановки до нуля выполнение потока возобновляется.
Синтаксис
DWORD ResumeThread(
[in] HANDLE hThread
);
Параметры
[in] hThread
Дескриптор для перезапуска потока.
Этот дескриптор должен иметь право доступа THREAD_SUSPEND_RESUME. Дополнительные сведения см. в разделе Thread Security and Access Rights.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение является предыдущим числом приостановки потока.
Если функция завершается ошибкой, возвращаемое значение равно -1. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Функция ResumeThread проверяет количество приостановки потока субъекта. Если число приостановки равно нулю, поток в настоящее время не приостановлен. В противном случае количество приостановки потока субъекта уменьшается. Если результирующее значение равно нулю, выполнение потока субъекта возобновляется.
Если возвращаемое значение равно нулю, указанный поток не был приостановлен. Если возвращаемое значение равно 1, указанный поток был приостановлен, но был перезапущен. Если возвращаемое значение больше 1, указанный поток по-прежнему приостановлен.
Обратите внимание, что при составлении отчетов о событиях отладки все потоки в процессе создания отчетов заморожены. Ожидается, что отладчики будут использовать функции SuspendThread и ResumeThread, чтобы ограничить набор потоков, которые могут выполняться в процессе. Приостанавливая все потоки в процессе, за исключением одного отчета о событии отладки, можно "один шаг" один поток. Другие потоки не освобождаются операцией продолжения, если они приостановлены.
Windows Phone 8.1: эта функция поддерживается для приложений Магазина Windows Phone в Windows Phone 8.1 и более поздних версиях.
Windows 8.1 и Windows Server 2012 R2: эта функция поддерживается для приложений Магазина Windows в Windows 8.1, Windows Server 2012 R2 и более поздних версий.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows XP [классические приложения | Приложения UWP] |
минимальный поддерживаемый сервер | Windows Server 2003 [классические приложения | Приложения UWP] |
целевая платформа | Виндоус |
заголовка | processthreadsapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
библиотеки | Kernel32.lib; WindowsPhoneCore.lib в Windows Phone 8.1 |
DLL | Kernel32.dll; KernelBase.dll в Windows Phone 8.1 |