win32_query_service_status
(PECL win32service >=0.1.0)
win32_query_service_status — Questionne le statut d'un service
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.