win32_set_service_status

(PECL win32service >=0.1.0)

win32_set_service_statusMet à jour le statut d'un service

Description

win32_set_service_status ( int $status [, int $checkpoint = 0 ] ) : bool

Informe le SCM d'un statut courant d'un service qui fonctionne. Cet appel est seulement valide pour un processus de service qui fonctionne.

Attention

Depuis la version 0.2.0, cette fonction fonctionne uniquement en ligne de commande. Elle est désactivé dans les autres cas.

Liste de paramètres

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.

checkpoint

Cette 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.

Valeurs de retour

Returns TRUE on success, FALSE if there is a problem with the parameters or a Win32 Error Code on failure.

Erreurs / Exceptions

Si cette fonction est utilisé en dehors du SAPI "cli", une erreur E_ERROR sera émise.

Historique

Version Description
0.2.0 Cette fonction fonctionne uniquement en ligne de commande.

Voir aussi