PHP: win32_query_service_status - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

win32_set_service_status win32_get_last_control_message

Last updated: Fri, 26 Jan 2007

view this page in

# win32_query_service_status

(PECL)

win32_query_service_status -- Queries the status of a service

## Описание

mixed win32_query_service_status ( string servicename [, string machine] )

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

## Список параметров

`servicename`

  The short name of the service.

`machine`

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

## Возвращаемые значения

Returns `FALSE` on failure, otherwise returns an array consisting of the following information:

`ServiceType`

  The dwServiceType.

`CurrentState`

  The dwCurrentState.

`ControlsAccepted`

  Which service controls are accepted by the service.

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

add a note User Contributed Notes
win32_query_service_status
mnemotronic at netscape dot net
25-Oct-2006 07:30
`If the service specified is non-existant, "win32_query_service_status" seems to return an integer, not the expected FALSE value:
$svcStatus=win32_query_service_status ('_bogons_');
echo $svcStatus ;
prints 1060
-- This is for xampp PHP; v5.1.6`
add a note
win32_set_service_status win32_get_last_control_message

Last updated: Fri, 26 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 10:36:09 2007 PST