Функция GetExitCodeProcess

Функция GetExitCodeProcess

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

Синтаксис

BOOL GetExitCodeProcess(

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

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

);

Параметры

hProcess

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

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

lpExitCode

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

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

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

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

Замечания

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

Значение выхода, определяемое в функции ExitProcess или TerminateProcess.

Величиной возвращаемого значения от функции main или функции WinMain процесса.

Значение исключительной ситуации для необработанного исключения, которое заставило завершить работу процесса.

Внимание!, если случается, что процесс возвращает значение 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	Нет
Замечания по платформе	Не имеется

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

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

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