array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', 2 => 'Elimina una entrada de servicio de la base de datos SCM', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Funciones win32service', ), 'prev' => array ( 0 => 'function.win32-create-service.php', 1 => 'win32_create_service', ), 'next' => array ( 0 => 'function.win32-get-last-control-message.php', 1 => 'win32_get_last_control_message', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/win32service/functions/win32-delete-service.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_service — Elimina una entrada de servicio de la base de datos SCM

Descripción

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

Intenta eliminar un servicio de la base de datos SCM. Los privilegios de administrador son necesarios para que esta función tenga éxito.

Esta función solo marca el servicio para eliminación. Si otros procesos (como el Applet Services) están abiertos, entonces la eliminación será pospuesta hasta que estas aplicaciones se cierren. Si un servicio está marcado para eliminación, otros intentos de eliminación fallarán y los intentos de crear un nuevo servicio con ese nombre también fallarán.

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, 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.

Ejemplos

Ejemplo #1 Ejemplo con win32_delete_service()

Elimina el servicio dummyphp.

<?php
win32_delete_service('dummyphp');
?>

Ver también