(PECL win32service >=0.1.0)
win32_get_last_control_message — サービスに送信された直近の制御メッセージを返す
サービスプロセスに送信された、直近の制御コードを返します。 サービスの実行中は、サービスを停止させる必要がないかを調べるために 定期的にこれをチェックすべきです。
0.2.0 以降では、この関数は "cli" SAPI でのみ動作します。 他の SAPI では、この関数は無効になっています。
この関数にはパラメータはありません。
制御コード定数を返します。以下の
Win32Service サービス制御メッセージ定数
のひとつです。
WIN32_SERVICE_CONTROL_CONTINUE
,
WIN32_SERVICE_CONTROL_DEVICEEVENT
,
WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE
,
WIN32_SERVICE_CONTROL_INTERROGATE
,
WIN32_SERVICE_CONTROL_NETBINDADD
,
WIN32_SERVICE_CONTROL_NETBINDDISABLE
,
WIN32_SERVICE_CONTROL_NETBINDENABLE
,
WIN32_SERVICE_CONTROL_NETBINDREMOVE
,
WIN32_SERVICE_CONTROL_PARAMCHANGE
,
WIN32_SERVICE_CONTROL_PAUSE
,
WIN32_SERVICE_CONTROL_POWEREVENT
,
WIN32_SERVICE_CONTROL_PRESHUTDOWN
,
WIN32_SERVICE_CONTROL_SESSIONCHANGE
,
WIN32_SERVICE_CONTROL_SHUTDOWN
,
WIN32_SERVICE_CONTROL_STOP
。
値が 128 から 255 の場合、制御コードはカスタムの値です。
バージョン 1.0.0 より前のバージョンでは、SAPI が "cli"
でない場合、
この関数は E_ERROR
レベルのエラーを発生させていました。
バージョン 1.0.0 移行は、
SAPI が "cli"
でない場合、
Win32ServiceException がスローされます。
バージョン | 説明 |
---|---|
PECL win32service 1.0.0 |
引数に不正な値があった場合、
ValueError をスローするようになりました。
これより前のバージョンでは、false を返していました。
|
PECL win32service 1.0.0 | エラー時に Win32ServiceException をスローするようになりました。 これより前のバージョンでは、 Win32 エラーコード を返していました。 |
PECL win32service 0.2.0 |
この関数は "cli" SAPI でのみ動作するようになりました。
|