WIN32_QUERY_SERVICE_STATUS(3)						 1					     WIN32_QUERY_SERVICE_STATUS(3)

win32_query_service_status - Queries the status of a service

SYNOPSIS

       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)