Функция RestartDialogEx (shlobj_core.h)

Статья
03/15/2023

[Эта функция доступна в Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003. Он может быть изменен или недоступен в последующих версиях Windows.]

Отображает диалоговое окно с запросом на перезагрузку Windows. Когда пользователь нажимает кнопку, функция вызывает ExitWindowsEx , чтобы попытаться перезапустить Windows.

Синтаксис

int RestartDialogEx(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn,
                 DWORD  dwReasonCode
);

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна.

[in, optional] pszPrompt

Тип: PCWSTR

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

dwReturn

Тип: DWORD

Флаги, указывающие тип завершения работы.

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

EWX_LOGOFF

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

EWX_POWEROFF

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

EWX_REBOOT

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

EWX_SHUTDOWN

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

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

EWX_FORCE

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

EWX_FORCEIFHUNG

Принудительно завершает работу процессов, если они не отвечают на WM_QUERYENDSESSION или WM_ENDSESSION сообщение. Этот флаг игнорируется, если используется EWX_FORCE.

dwReasonCode

Тип: DWORD

Windows XP:Указывает причину инициации завершения работы. Дополнительные сведения см. в разделе Коды причин завершения работы системы.

Windows 2000: Этот параметр игнорируется.

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

Тип: int

Возвращает идентификатор кнопки, которая была нажата для закрытия диалогового окна.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)

Поделиться через