Функция GetExitCodeProcess

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

Синтаксис

BOOL GetExitCodeProcess(

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

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

);

Параметры

hProcess

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

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

lpExitCode

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

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

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

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

Замечания

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

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

Смотри также

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

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

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