RestartDialogEx 함수(shlobj_core.h)

아티클
08/26/2023

[이 함수는 Windows XP SP2(서비스 팩 2) 및 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

사용자에게 메시지를 표시하기 위해 대화 상자에 표시되는 텍스트가 포함된 null로 끝나는 문자열입니다.

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
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)

다음을 통해 공유