Elimina una entrada de servicio de la base de datos SCM

# win32_delete_service

(PECL win32service >=0.1.0)

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

### Descripción

function 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

- win32_create_service() - Crea una nueva entrada para servicio en la base de datos SCM
- Los códigos de error Win32

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open