RestartDialogEx 関数 (shlobj_core.h)

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

Windows XP:シャットダウンを開始する理由を指定します。 詳細については、「 システム シャットダウン理由コード」を参照してください。

Windows 2000: このパラメーターは無視されます。

戻り値

型: int

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

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)