win32_send_custom_control
(PECL win32service >=0.4.0)
win32_send_custom_control — Send a custom control to the service
Beschreibung
See » Microsoft ControlService function for more details
Parameter-Liste
-
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.
Rückgabewerte
Es wird kein Wert zurückgegeben.
Prior to version 1.0.0, wurde im Erfolgsfall WIN32_NO_ERROR zurückgegeben und false, wenn es ein Problem mit den Parametern gab oder einen Win32-Fehlercode im Fehlerfall.
Fehler/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 | Beschreibung |
|---|---|
| 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. |
Siehe auch
- win32_start_service() - Starts a service
- win32_stop_service() - Stops a service
- win32_pause_service() - Pauses a service
- win32_continue_service() - Resumes a paused service
- Win32 Error Codes
add a note
