array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', 2 => 'Supprime une entrée de service de la base de données SCM', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Fonctions 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' => 'fr', '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 — 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