win32_delete_service

win32_delete_service(string $servicename, [string $machine]): void
```php

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](#win32service.constants.errors) 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](#win32service.constants.errors) era retornado. |
| PECL win32service 1.0.0 | El tipo de retorno es ahora `void`, antes era `mixed`. |

## Ejemplos

Ejemplo con `win32_delete_service`

Elimina el servicio dummyphp.