WIN32_QUERY_SERVICE_STATUS(3) 1 WIN32_QUERY_SERVICE_STATUS(3)win32_query_service_status - Queries the status of a serviceSYNOPSIS
mixed win32_query_service_status (string $servicename, [string $machine])
DESCRIPTION
Queries the current status for a service, returning an array of information.
PARAMETERS
o $servicename
- The short name of the service.
o $machine
- The optional machine name. If omitted, the local machine will be used.
RETURN VALUES
Returns an array consisting of the following information on success, FALSE if there is a problem with the parameters or a Win32 Error Code
on failure.
o $ServiceType
- The dwServiceType. See Win32Service Service Type Bitmasks.
o $CurrentState
- The dwCurrentState. See Win32Service Service Status Constants.
o $ControlsAccepted
- Which service controls are accepted by the service. See Win32Service Service Control Message Accepted Bitmasks.
o $Win32ExitCode
- If the service exited, the return code from the process.
o $ServiceSpecificExitCode
- If the service exited with an error condition, the service specific code that is logged in the event log is visible here.
o $CheckPoint
- If the service is shutting down, holds the current check point number. This is used by the SCM as a kind of heart-beat to detect
a wedged service process. The value of the check point is best interpreted in conjunction with the WaitHint value.
o $WaitHint
- If the service is shutting down it will set WaitHint to a checkpoint value that will indicate 100% completion. This can be used
to implement a progress indicator.
o $ProcessId
- The Windows process identifier. If 0, the process is not running.
o $ServiceFlags
- The dwServiceFlags. See Win32Service Service Service Flag Constants.
SEE ALSO
Win32Service Predefined Constants.
PHP Documentation Group WIN32_QUERY_SERVICE_STATUS(3)