Функция ExitWindowsEx (winuser.h)

Выключает интерактивного пользователя, завершает работу системы или завершает работу и перезапускает систему. Он отправляет сообщение WM_QUERYENDSESSION всем приложениям, чтобы определить, можно ли их завершить.

Синтаксис

BOOL ExitWindowsEx(
  [in] UINT  uFlags,
  [in] DWORD dwReason
);

Параметры

[in] uFlags

Тип завершения работы. Этот параметр должен включать одно из следующих значений.

При необходимости этот параметр может включать одно из следующих значений.

[in] dwReason

Причина инициации завершения работы. Этот параметр должен быть одним из кодов причин завершения работы системы.

Если этот параметр равен нулю, код причины SHTDN_REASON_FLAG_PLANNED не будет задан, поэтому действием по умолчанию является неопределенное завершение работы, которое регистрируется как "Не удалось найти название по этой причине". По умолчанию это также незапланированное завершение работы. В зависимости от того, как настроена система, незапланированное завершение работы запускает создание файла, содержащего сведения о состоянии системы, что может задержать завершение работы. Поэтому не используйте ноль для этого параметра.

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

Если функция выполняется успешно, возвращается ненулевое значение. Так как функция выполняется асинхронно, ненулевое возвращаемое значение указывает на то, что завершение работы было инициировано. Он не указывает, будет ли завершение работы успешно завершено. Вполне возможно, что система, пользователь или другое приложение прервет завершение работы.

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

Комментарии

Функция ExitWindowsEx возвращается, как только она инициирует процесс завершения работы. Завершение работы или выход из системы выполняется асинхронно. Функция предназначена для остановки всех процессов в сеансе входа вызывающего абонента. Таким образом, если вы не являетесь интерактивным пользователем, функция может быть успешной без фактического завершения работы компьютера. Если вы не являетесь интерактивным пользователем, используйте функцию InitiateSystemShutdown или InitiateSystemShutdownEx .

Ненулевое возвращаемое значение не означает, что выход был или будет успешным. Завершение работы — это асинхронный процесс, который может происходить через много времени после возврата вызова API или вообще не происходит. Даже если время ожидания равно нулю, завершение работы по-прежнему может быть прервано приложениями, службами или даже системой. Ненулевое возвращаемое значение указывает, что проверка прав и параметров прошла успешно и что система приняла запрос на завершение работы.

При вызове этой функции вызывающий объект должен указать, следует ли принудительно закрывать приложения с несохраненных изменений. Если вызывающий объект решит не принудительно закрывать эти приложения и приложение с несохраненных изменений запущено в сеансе консоли, завершение работы будет продолжаться до тех пор, пока пользователь, выполнивший вход в сеанс консоли, не прервет завершение работы, сохранит изменения, не закроет приложение или не заставит приложение закрыться. В течение этого периода завершение работы может быть прервано только пользователем консоли, и другое завершение работы не может быть инициировано.

Вызов этой функции со значением параметра uFlags , равным EWX_FORCE, позволяет избежать такой ситуации. Помните, что это может привести к потере данных.

Чтобы задать приоритет завершения работы приложения относительно других приложений в системе, используйте функцию SetProcessShutdownParameters .

Во время завершения работы или выхода из системы запущенным приложениям разрешено определенное количество времени, чтобы ответить на запрос на завершение работы. Если это время истечет до остановки всех приложений, система отображает пользовательский интерфейс, позволяющий пользователю принудительно завершить работу системы или отменить запрос на завершение работы. Если указано значение EWX_FORCE, система принудительно останавливает выполнение приложений по истечении времени.

Если указано значение EWX_FORCEIFHUNG, система принудительно закрывает зависающее приложение и не отображает диалоговое окно.

Консольные процессы получают отдельное уведомление, CTRL_SHUTDOWN_EVENT или CTRL_LOGOFF_EVENT, как того требует ситуация. Процесс консоли направляет эти сообщения в свою функцию HandlerRoutine . ExitWindowsEx отправляет эти уведомления асинхронно; Таким образом, приложение не может предположить, что сообщения уведомлений консоли были обработаны при вызове ExitWindowsEx .

Чтобы завершить работу или перезапустить систему, вызывающий процесс должен использовать функцию AdjustTokenPrivileges , чтобы включить привилегию SE_SHUTDOWN_NAME. Дополнительные сведения см. в разделе Выполнение с особыми привилегиями.

Примеры

Пример см. в разделе Завершение работы системы.

Требования

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

AdjustTokenPrivileges

HandlerRoutine

Выход из системы

SetProcessShutdownParameters

Завершает работу

Функции завершения работы системы