win32_send_custom_control
(PECL win32service >=0.4.0)
win32_send_custom_control — Send a custom control to the service
説明
win32_send_custom_control
( string $servicename
, int $control
[, string $machine
] ) : void
See » Microsoft ControlService function for more details
パラメータ
servicename
- The short name of the service.
control
- The custom contole value between 128 and 255.
machine
- Optional machine name. If omitted, the local machine is used.
返り値
値を返しません。
Prior to version 1.0.0, 成功した場合に WIN32_NO_ERROR
を返していました。パラメータに問題がある場合は false
、失敗した場合は Win32 エラーコード を返します。
エラー / 例外
Prior to version 1.0.0, if the control value is not between 128 and 255, this function emits an
E_ERROR
level error.
A ValueError is thrown if the;
value of servicename
parameter is empty.
A ValueError is thrown if the;
value of control
parameter is not between 128 and 255.
A Win32ServiceException is thrown on error.
変更履歴
バージョン | 説明 |
---|---|
PECL win32service 1.0.0 | Throws a ValueError on invalid data in parameters,
previously |
PECL win32service 1.0.0 | Throws a Win32ServiceException on error,
previously a Win32 Error Code was returned. |
PECL win32service 1.0.0 | The return type is now void, previously it was mixed. |
参考
- win32_start_service() - サービスを開始する
- win32_stop_service() - サービスを停止する
- win32_pause_service() - サービスを中断する
- win32_continue_service() - 中断したサービスを再開する
- Win32 Error Codes