(PECL win32service >=0.1.0)
win32_set_service_status — Met à jour le statut d'un service
$status, int $checkpoint = 0): voidInforme le SCM d'un statut courant d'un service qui fonctionne. Cet appel est seulement valide pour un processus de service qui fonctionne.
Depuis la version 0.2.0, cette fonction fonctionne uniquement en ligne de commande. Elle est désactivé dans les autres cas.
status
Le code de statut de service, un de
WIN32_SERVICE_RUNNING,
WIN32_SERVICE_STOPPED,
WIN32_SERVICE_STOP_PENDING,
WIN32_SERVICE_START_PENDING,
WIN32_SERVICE_CONTINUE_PENDING,
WIN32_SERVICE_PAUSE_PENDING,
WIN32_SERVICE_PAUSED.
checkpointCette valeur sera incrémentée par le service périodiquement pour reporter sa progression lors des opérations de démarrage, d'arrêt, de pause ou de reprise. Par exemple, le service incrémentera cette valeur lorsqu'il aura terminé chaque étape de son initialisation lors de son démarrage.
checkpoint n'est valide que lorsque
status est une des constantes suivantes :
WIN32_SERVICE_STOP_PENDING,
WIN32_SERVICE_START_PENDING,
WIN32_SERVICE_CONTINUE_PENDING ou
WIN32_SERVICE_PAUSE_PENDING.
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.
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"
| 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. |
| PECL win32service 0.2.0 | Cette fonction fonctionne uniquement en ligne de commande. |