Forum und email

win32_query_service_status

(No version information available, might be only in CVS)

win32_query_service_status — Questionne le statut d'un service

Description

mixed win32_query_service_status ( string $servicename [, string $machine ] )

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 FALSE en cas d'échec, autrement retourne un tableau contenant les informations suivantes :

ServiceType

Le dwServiceType.

CurrentState

Le dwCurrentState.

ControlsAccepted

Quels contrôles de service sont acceptés par le service.

Win32ExitCode

Si le service quitte, le code de retour du processus.

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.

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