win32_pause_service
PHP function
Edit on GitHub ✎
Pauses a service
Description
win32_pause_service(string $servicename, string $machine = null): void
Pauses a named service. Requires administrative privileges or an account with appropriate rights set in the service's ACL.
Parameters
servicenameThe short name of the service.
machineOptional machine name. If omitted, the local machine is used.
Return Values
Void
Prior to version 1.0.0, Error
Errors/Exceptions
A ValueError is thrown if the value of servicename parameter is empty.
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. |
| PECL win32service 0.3.0 | This function does not longer require an administrator account if ACL is set for another account. |