# win32_set_service_exit_mode

(PECL win32service >=0.4.0)

win32_set_service_exit_mode — Définir ou renvoyer le mode de sortie pour le service en cours d'exécution

### Description

win32_set_service_exit_mode(bool `$gracefulMode` = true): bool

Si le paramètre `gracefulMode` est fourni, le mode de sortie est modifié. Lorsque le mode de sortie n'est pas gracefuly, le code de sortie utilisé peut être défini avec la fonction win32_set_service_exit_code().

Attention

Cette fonction fonctionne uniquement dans SAPI "cli". Sur d'autres SAPI, cette fonction est désactivée.

### Liste de paramètres

`gracefulMode`

  `true` pour la sortie gracieuse. `false` pour la sortie avec erreur.

### Valeurs de retour

Retournez le mode de sortie actuel ou ancien.

### Erreurs / Exceptions

Avant la version 1.0.0, si cette fonction est utilisé en dehors du SAPI `"cli"`, une erreur `E_ERROR` sera émise.

À partir de la version 1.0.0, lancera une Win32ServiceException si le SAPI n'est pas `"cli"`

### 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é.

### Voir aussi

- win32_start_service_ctrl_dispatcher() - Enregistre un script avec SCM, alors il peut être interprété en tant que service avec le nom donné
- win32_set_service_status() - Met à jour le statut d'un service
- win32_set_service_exit_code() - Définir ou renvoyer le code de sortie pour le service en cours d'exécution