Функция ResumeThread

Функция ResumeThread

Функция ResumeThread уменьшает счет времени приостановки работы потока. Когда счет времени приостановки работы уменьшается до нуля, выполнение потока продолжается.

Синтаксис

DWORD ResumeThread(

HANDLE hThread // дескриптор потока

);

Параметры

hThread

[in] Дескриптор для потока, который будет перезагружен.

Windows NT/2000/XP: дескриптор должен иметь право доступа THREAD_SUSPEND_RESUME. Для получения дополнительной информации, см. статью Защита потока и права доступа

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

Если функция завершается успешно, величина возвращаемого значения - предшествующий счет времени приостановки работы потока.

Если функция завершается с ошибкой, величина возвращаемого значения равна - (минус) 1. Чтобы получить дополнительные данные об ошибках, вызовите GetLastError.

Замечания

Функция ResumeThread проверяет счет времени приостановки работы подчиненного потока. Если счет времени приостановки работы равен 0, поток в настоящее время не приостановлен. Иначе, счет времени приостановки работы подчиненного потока уменьшается. Если итоговое значение - 0, то выполнение подчиненного потока продолжается.

Если величина возвращаемого значения - ноль, заданный поток не был приостановлен. Если величина возвращаемого значения равна 1, заданный поток приостановлен, но был перезагружен. Если величина возвращаемого значения больше чем 1, заданный поток все еще приостанавливается.

Обратите внимание! на то, что при сообщении о событиях отладки, все потоки в пределах сообщающего процесса замораживаются. Предполагается, что отладчики используют функции SuspendThread и ResumeThread, чтобы ограничить установку потоков, которые могут выполняться в пределах процесса. Приостановка работы всех потоков в процессе предполагает, что один дает отчет о событии отладки, что возможно в " пошаговом" режиме отладки отдельного потока. Другие потоки не освобождаются от продолжения операций, если они приостановлены.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, OpenThread, SuspendThread

Размещение и совместимость ResumeThread
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Kernel32.lib
Заголовочный файл
- объявлено в	Winbase.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки