SetProcessShutdownParameters 関数 (processthreadsapi.h)
現在呼び出しているプロセスのシャットダウン パラメーターを設定します。 この関数は、システム内の他のプロセスに対するプロセスのシャットダウン順序を設定します。
構文
BOOL SetProcessShutdownParameters(
[in] DWORD dwLevel,
[in] DWORD dwFlags
);
パラメーター
[in] dwLevel
システム内の他のプロセスに対するプロセスのシャットダウン優先度。 システムは、高い dwLevel 値から低い値にプロセスをシャットダウンします。 シャットダウンの優先度が最も高く、最も低いのは、システム コンポーネント用に予約されています。 このパラメーターは、次の値の範囲内にある必要があります。
| 値 | 説明 |
|---|---|
|
システムによって予約された最後のシャットダウン範囲。 |
|
アプリケーションによって予約された最後のシャットダウン範囲。 |
|
アプリケーションが "中間" シャットダウン範囲で予約されました。 |
|
アプリケーション予約済みの最初のシャットダウン範囲。 |
|
システム予約の最初のシャットダウン範囲。 |
すべてのプロセスは、シャットダウン レベルの0x280から開始されます。
[in] dwFlags
このパラメーターには、次の値を指定できます。
| 値 | 説明 |
|---|---|
|
システムは、ユーザーの再試行ダイアログ ボックスを表示せずにプロセスを終了します。 |
戻り値
関数が成功した場合、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
システム セキュリティ コンテキストで実行されているアプリケーションは、オペレーティング システムによってシャットダウンされません。 SetConsoleCtrlHandler 経由でインストール可能なコールバック関数を使用して、シャットダウンまたはログオフの通知を受け取ります。 また、 dwLevel パラメーターで指定された順序で通知を受け取ります。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 の Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |