Функция GetExitCodeThread

Функция GetExitCodeThread извлекает данные о состоянии завершения заданного потока.

Синтаксис

BOOL GetExitCodeThread(

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

LPDWORD lpExitCode // статус завершения

);

Параметры

hThread

[in] Дескриптор потока.

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

lpExitCode

[out] Указатель на переменную, которая получает состояние завершения потока.

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

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

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

Замечания

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

Внимание!, если случается, что поток возвращает значение STILL_ACTIVE (259) как код ошибки, приложения, которые проверяют это значение, могут оказаться в бесконечном цикле.

Смотри также

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

Размещение и совместимость GetExitCodeThread

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz