win32_pause_service
(PECL win32service >=0.1.0)
win32_pause_service — Pauses a service
Descrição
Pauses a named service. Requires administrative privileges or an account with appropriate rights set in the service's ACL.
Parâmetros
-
servicename -
The short name of the service.
-
machine -
Optional machine name. If omitted, the local machine is used.
Valor Retornado
Nenhum valor é retornado.
Prior to version 1.0.0, retornava WIN32_NO_ERROR em caso de sucesso, false se houver um problema com os parâmetros ou um Código de Erro Win32 em caso de falha.
Erros/Exceções
A ValueError is thrown if the
value of servicename parameter is empty.
A Win32ServiceException is thrown on error.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 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. |
Veja Também
- win32_start_service() - Starts a service
- win32_stop_service() - Stops a service
- win32_continue_service() - Resumes a paused service
- win32_send_custom_control() - Send a custom control to the service
- Win32 Error Codes
add a note
User Contributed Notes
There are no user contributed notes for this page.
