RestartDialog 函式 (shlobj_core.h)

[此函式可透過 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 取得。在後續版本的 Windows 中，它可能會改變或無法使用。

顯示對話框，提示使用者重新啟動 Windows。當使用者按鍵時，函式會呼叫 ExitWindowsEx 嘗試重新啟動 Windows。

語法

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

[in, optional] hwnd

類型： HWND

父視窗的句柄。

[in, optional] pszPrompt

類型： PCWSTR

Null 終止的 Unicode 字串，其中包含提示使用者之對話框中顯示的文字。

dwReturn

類型： DWORD

指定關機類型的旗標。

此參數必須包含下列其中一個值。

關閉在呼叫此函式之進程的安全性內容中執行的所有進程，然後註銷使用者。

關閉系統並關閉電源。系統必須支援關閉電源功能。呼叫進程必須具有 SE_SHUTDOWN_NAME 許可權。如需詳細資訊，請參閱 ExitWindowsEx。

關閉系統，然後重新啟動系統。呼叫進程必須具有 SE_SHUTDOWN_NAME 許可權。如需詳細資訊，請參閱 ExitWindowsEx。

將系統關機到關閉電源的安全點。此時，所有檔案緩衝區都已排清到磁碟，而且所有執行中的進程都已停止。如果系統支援關閉電源功能，電源也會關閉。呼叫進程必須具有 SE_SHUTDOWN_NAME 許可權。如需詳細資訊，請參閱 ExitWindowsEx。

此參數可以選擇性地包含下列值。

強制進程終止。設定此旗標時，系統不會傳送 WM_QUERYENDSESSION 和 WM_ENDSESSION 訊息。這可能會導致應用程式遺失數據。因此，您應該只在緊急狀況中使用這個旗標。

強制進程在未回應 WM_QUERYENDSESSION 或 WM_ENDSESSION 訊息時終止。如果使用 EWX_FORCE ，則會忽略此旗標。

類型： int

傳回按下以關閉對話框之按鈕的標識碼。