win32_send_custom_control
PHP function
Edit on GitHub ✎
Send a custom control to the service
Description
win32_send_custom_control(string $servicename, int $control, string $machine = null): void
See Microsoft ControlService function for more details
Parameters
servicenameThe short name of the service.
controlThe custom contole value between 128 and 255.
machineOptional machine name. If omitted, the local machine is used.
Return Values
Void
Prior to version 1.0.0, Error
Errors/Exceptions
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.
Changelog
| Version | Description |
|---|---|
| PECL win32service 1.0.0 | Throws a ValueError on invalid data in parameters, previously false was returned. |
| 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. |