SetProcessShutdownParameters 関数 (processthreadsapi.h)

  • [アーティクル]

現在呼び出しているプロセスのシャットダウン パラメーターを設定します。 この関数は、システム内の他のプロセスに対するプロセスのシャットダウン順序を設定します。

構文

BOOL SetProcessShutdownParameters(
  [in] DWORD dwLevel,
  [in] DWORD dwFlags
);

パラメーター

[in] dwLevel

システム内の他のプロセスに対するプロセスのシャットダウン優先度。 システムは、高い dwLevel 値から低い値にプロセスをシャットダウンします。 シャットダウンの優先度が最も高く、最も低いのは、システム コンポーネント用に予約されています。 このパラメーターは、次の値の範囲内にある必要があります。

値 説明
000-0FF
 システムによって予約された最後のシャットダウン範囲。
100-1FF
 アプリケーションによって予約された最後のシャットダウン範囲。
200-2FF
 アプリケーションが "中間" シャットダウン範囲で予約されました。
300-3FF
 アプリケーション予約済みの最初のシャットダウン範囲。
400-4FF
 システム予約の最初のシャットダウン範囲。
 

すべてのプロセスは、シャットダウン レベルの0x280から開始されます。

[in] dwFlags

このパラメーターには、次の値を指定できます。

値 説明
SHUTDOWN_NORETRY
0x00000001
 システムは、ユーザーの再試行ダイアログ ボックスを表示せずにプロセスを終了します。

戻り値

関数が成功した場合、戻り値は 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

関連項目

GetProcessShutdownParameters

プロセス関数とスレッド関数

処理

SetConsoleCtrlHandler