sapi_windows_set_ctrl_handler
CTRLイベント のハンドラを設定したり削除したりする
&reftitle.description;
boolsapi_windows_set_ctrl_handler
callablenullhandler
booladd&true;
CTRL イベントのハンドラを設定したり削除したりします。
これによって、Windows の CLI プロセスが、
CTRL
C
や
CTRL
BREAK
イベントに割り込んだり、無視したり出来るようになります。
マルチスレッド環境では、この操作はメインスレッドからのみ可能です。
&reftitle.parameters;
handler
設定したり削除したりするコールバック関数。
設定した場合、この関数は
CTRL
C
や
CTRL
BREAK
イベントが発生した場合にいつでも呼び出されます。
関数のシグネチャは次のとおりです:
voidhandler
intevent
event
受け取った CTRL イベント;
PHP_WINDOWS_EVENT_CTRL_C
または PHP_WINDOWS_EVENT_CTRL_BREAK
&null; を handler に設定すると、
CTRL
C
イベント をプロセスに無視させますが、
CTRL
BREAK
イベントは無視しません。
add
&true; に設定し、ハンドラを設定します。
&false; の場合、ハンドラは削除されます。
&reftitle.returnvalues;
&return.success;
&reftitle.examples;
基本的な sapi_windows_set_ctrl_handler 関数の使い方
以下の例は、 CTRLイベント にどのように割り込むかを示しています。
]]>
&reftitle.seealso;
sapi_windows_generate_ctrl_event