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
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
add a note
