RestartDialog 関数 (shlobj_core.h)

[アーティクル]
08/26/2023

[この機能は、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

シャットダウンの種類を指定するフラグ。

このパラメーターには、次のいずれかの値を含める必要があります。

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を使用する場合、このフラグは無視されます。

戻り値

型: int

ダイアログボックスを閉じるのに押されたボタンの識別子を返します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)
API セット	ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入)