Функция ResumeThread (processthreadsapi.h)

  • Статья

Уменьшает количество приостановок потока. Если число приостановки уменьшается до нуля, выполнение потока возобновляется.

Синтаксис

DWORD ResumeThread(
  [in] HANDLE hThread
);

Параметры

[in] hThread

Дескриптор для перезагружаемого потока.

Этот дескриптор должен иметь право доступа к THREAD_SUSPEND_RESUME. Дополнительные сведения см. в разделе Безопасность потоков и права доступа.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение — это предыдущее число приостановки потока.

Если функция завершается сбоем, возвращается значение (DWORD) -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]
Целевая платформа Windows
Header 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

См. также раздел

OpenThread

Функции процессов и потоков

SuspendThread

Приостановка выполнения потока

Потоки