win32_pause_service

win32_pause_service

Pone en pausa un servicio

Descripción#

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

Pone en pausa un servicio. Se requieren privilegios de administrador o una cuenta con los derechos adecuados definidos en la ACL del servicio.

Parámetros#

servicename
El nombre corto del servicio.

machine
Nombre de la máquina (opcional). 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á una ValueError si el valor del argumento servicename está vacío.

Se lanzará una Win32ServiceException en caso de error.

Historial de cambios#

Versión	Descripción
PECL win32service 1.0.0	Lanzará una ValueError si un argumento es inválido, antes false era retornado.
PECL win32service 1.0.0	Lanzará una Win32ServiceException en caso de error, antes un Código de error Win32 era retornado.
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 la ACL está definida para otra cuenta.

Véase también#

win32_start_service, win32_stop_service, win32_continue_service, win32_send_custom_control, Los códigos de error Win32