# win32_query_service_status

(PECL win32service >=0.1.0)

win32_query_service_status — Questionne le statut d'un service

### Description

win32_query_service_status(string `$servicename`, string `$machine` = `null`): array

Questionne le statut courant pour un service, retournant un tableau d'informations.

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

Retourne un tableau contenant les informations suivantes en cas de succès.

Avant la version 1.0.0, `false` if there is a problem with the parameters or a Win32 Error Code on failure.

`ServiceType`

  Le dwServiceType. Voir les masques de type de service Win32Service.

`CurrentState`

  Le dwCurrentState. Voir les constantes de statut des services Win32Service.

`ControlsAccepted`

  Quels contrôles de service sont acceptés par le service. Voir les masques acceptés pour les messages de contrôle de service Win32Service.

`Win32ExitCode`

  Si le service quitte, le code de retour du processus. Cette valeur est égale à `WIN32_ERROR_SERVICE_SPECIFIC_ERROR` si le mode de sortie n'est pas gracieux. Voir codes d'erreur Win32Service et win32_set_service_exit_mode().

`ServiceSpecificExitCode`

  Si le service quitte avec une condition d'erreur, le code spécifique du service qui sera enregistré dans le journal d'évènements est visible ici. Cette valeur est égale à la valeur définie par win32_set_service_exit_code().

`CheckPoint`

  Si le service s'arrête, garde le nombre courant de point de contrôle. Ceci est utilisé par SCM comme un genre de battement de cœur pour détecter un processus de service arrêté. La valeur du point de contrôle est mieux interprétée en conjonction avec la valeur WaitHint.

`WaitHint`

  Si le service s'arrête, il fixera un WaitHint à une valeur de point de contrôle qui indiquera l'exécution 100%. Cela peut être utilisé pour implanter un indicateur de progrès.

`ProcessId`

  L'identifiant de processus de fenêtre. Si 0, le processus ne fonctionne pas.

`ServiceFlags`

  Le dwServiceFlags. Voir les constantes utilisées pour les drapeaux des services Win32Service.

### Erreurs / Exceptions

Une ValueError est levée si la valeur du paramètre `servicename` est vide.

### 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 array, avant il était mixed.

### Voir aussi

- Les constantes Win32Service prédéfinies