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

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

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

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

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

要件