raise

実行中のプログラムにシグナルを送信します。

Note

テストやデバッグのシナリオの場合を除き、この方法を使用して Microsoft Store アプリをシャットダウンしないでください。 プログラムまたは UI を使用して Store アプリを閉じる方法は、Microsoft Store ポリシーでは許可されていません。 詳細については、UWP アプリのライフサイクルに関するページを参照してください。

構文

int raise(
   int sig
);

パラメーター

sig
発生するシグナル。

戻り値

正常に終了した場合、raise は 0 を返します。 それ以外の場合は、0 以外の値を返します。

解説

raise関数は、実行中のプログラムにsigを送信します。 signalの以前の呼び出しでsigのシグナル処理関数がインストールされている場合は、その関数raise実行されます。 ハンドラー関数がインストールされていない場合は、次のように、 sig シグナル値に関連付けられている既定のアクションが実行されます。

Signal 説明 既定の動作
SIGABRT 異常終了 コード 3 で呼び出し元のプログラムを終了する
SIGFPE 浮動小数点エラー 呼び出し元のプログラムを終了します。
SIGILL 無効な命令 呼び出し元のプログラムを終了します。
SIGINT Ctrl + C 割り込み 呼び出し元のプログラムを終了します。
SIGSEGV ストレージへの無効なアクセス 呼び出し元のプログラムを終了します。
SIGTERM プログラムに送信される終了要求 シグナルを無視する

引数が上記で指定した有効なシグナルでない場合は、「 パラメーター検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 ハンドルされない場合、関数は errnoEINVAL に設定し、0 以外の値を返します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

要件

ルーチンによって返される値 必須ヘッダー
raise <signal.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

プロセスと環境の制御
abort
signal