# win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_service — Supprime une entrée de service de la base de données SCM

### Description

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

Essaie de supprimer un service de la base de données SCM. Les privilèges d'administrateur sont requis pour que cette fonction réussisse.

Cette fonction ne fait que marquer le service pour suppression. Si d'autre processus (comme l'Applet Services) sont ouverts, alors la suppression sera reportée jusqu'à ce que ces applications soient fermées. Si un service est marqué pour suppression, d'autres tentatives de suppression échoueront et les tentatives de créer un nouveau service avec ce nom échoueront aussi.

### Liste de paramètres

`servicename`

  Le nom court du service.

`machine`

  Le nom optionnel de la machine. Si oublié, cela utilisera la machine locale.

### Valeurs de retour

Aucune valeur n'est retournée.

Avant la version 1.0.0, retournait `WIN32_NO_ERROR` on success, `false` if there is a problem with the parameters or a Win32 Error Code on failure.

### Erreurs / Exceptions

Une ValueError est levée si la valeur du paramètre `servicename` est vide.

Une Win32ServiceException est levée en cas d'erreur.

### Historique

Version | Description
--- | ---
PECL win32service 1.0.0 | Lance une ValueError si un paramètre est invalide, avant `false` était retourné.
PECL win32service 1.0.0 | Lance une Win32ServiceException en cas d'erreur, avant un Code d'erreur Win32 était retourné.
PECL win32service 1.0.0 | Le type de retour est maintenant void, avant il était mixed.

### Exemples

Exemple #1 Exemple avec win32_delete_service()

Supprime le service dummyphp.

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

### Voir aussi

- win32_create_service() - Crée une nouvelle entrée pour service dans la base de données SCM
- Les codes erreur Win32