Queries the status of a service

# win32_query_service_status

(PECL win32service SVN)

win32_query_service_status — Queries the status of a service

### Descrierea

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

Queries the current status for a service, returning an array of information.

### Parametri

`servicename`

  The short name of the service.

`machine`

  The optional machine name. If omitted, the local machine will be used.

### Valorile întoarse

Returns an array consisting of the following information on success, `FALSE` în caz că este vre-o problemă cu parametrii, sau un Cod de Eroare Win32 în caz de eșec.

`ServiceType`

  The dwServiceType. See Win32Service Service Type Bitmasks.

`CurrentState`

  The dwCurrentState. See Win32Service Service Status Constants.

`ControlsAccepted`

  Which service controls are accepted by the service. See Win32Service Service Control Message Accepted Bitmasks.

`Win32ExitCode`

  If the service exited, the return code from the process.

`ServiceSpecificExitCode`

  If the service exited with an error condition, the service specific code that is logged in the event log is visible here.

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

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

`ProcessId`

  The Windows process identifier. If 0, the process is not running.

`ServiceFlags`

  The dwServiceFlags. See Win32Service Service Service Flag Constants.

### A se vedea și

- Win32Service Predefined Constants