win32_get_last_control_message
サービスに送信された直近の制御メッセージを返す
説明
int 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 がスローされます。
参考
- win32_start_service_ctrl_dispatcher
- win32_set_service_status
- win32_set_service_exit_mode
- win32_set_service_exit_code
- Win32Service サービス制御メッセージ定数