array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.win32-start-service.php', 1 => 'win32_start_service', 2 => 'Inicia un servicio', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Funciones win32service', ), 'prev' => array ( 0 => 'function.win32-set-service-status.php', 1 => 'win32_set_service_status', ), 'next' => array ( 0 => 'function.win32-start-service-ctrl-dispatcher.php', 1 => 'win32_start_service_ctrl_dispatcher', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/win32service/functions/win32-start-service.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_start_service

(PECL win32service >=0.1.0)

win32_start_service — Inicia un servicio

Descripción

win32_start_service(string $servicename, string $machine = null): void

Intenta iniciar el servicio nombrado. 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

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á 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, anteriormente false era retornado.
PECL win32service 1.0.0 Lanzará una Win32ServiceException en caso de error, anteriormente un Código de error Win32 era retornado.
PECL win32service 1.0.0 El tipo de retorno es ahora void, anteriormente 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.

Ver también