win32_stop_service

win32_stop_service

Detiene un servicio

Descripción#

php win32_stop_service(string $servicename, [string $machine]): voidphp

Detiene un servicio nombrado. Requiere privilegios de administrador o una cuenta con los derechos apropiados definidos en el ACL del servicio.

Parámetros#

servicename
El nombre corto del servicio.

machine
El nombre opcional de la máquina. Si se omite, se utilizará la máquina local.

Valores devueltos#

No se retorna ningún valor.

Antes de la versión 1.0.0, retornaba WIN32_NO_ERROR en caso de éxito, false si hay un problema con los parámetros o un Código de Error Win32 en caso de fallo.

Errores/Excepciones#

Se lanzará un ValueError si el valor del parámetro servicename está vacío.

Se lanzará un Win32ServiceException en caso de error.

Historial de cambios#

Versión	Descripción
PECL win32service 1.0.0	Lanzará un ValueError si un parámetro es inválido, antes se retornaba false.
PECL win32service 1.0.0	Lanzará un Win32ServiceException en caso de error, antes se retornaba un Código de error Win32 .
PECL win32service 1.0.0	El tipo de retorno es ahora void, antes era mixed.
PECL win32service 0.3.0	Esta función ya no requiere una cuenta de administrador si el ACL está definido para otra cuenta.

Véase también#

win32_start_service, win32_pause_service, win32_continue_service, win32_send_custom_control, Códigos de error Win32