RestartDialogEx 函式 (shlobj_core.h)

發行項
08/26/2023

[此函式可透過 Windows XP Service Pack 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

以 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

Windowsxp：指定起始關機的原因。如需詳細資訊，請參閱系統關機原因代碼。

Windows 2000： 忽略此參數。

傳回值

類型： int

傳回按下以關閉對話方塊之按鈕的識別碼。

需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)

共用方式為