Last updated: Fri, 10 Jul 2009

win32_query_service_status

(PECL win32service CVS)

win32_query_service_status — Queries the status of a service

Descrierea

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

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 întroarse

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

CM at chaosmixed dot com
16-Jun-2009 05:29


***Notice the name is IISADMIN and not IIS Admin


right click the serivce then, type in the "Service Name" not the "Display Name" or you will get 1060





<?php


$servicename ="IISADMIN";


$machine ="desktopper";


//print_r (win32_query_Service_status($servicename,$machine));





echo  $servicename;





$sray = win32_query_Service_status($servicename,$machine);





echo "<br>";





print_r ($sray);





echo "<ul>";


echo "<li>Service Type: " .$sray[ServiceType] . "</li>";


echo "<li>CurrentState: " .$sray[CurrentState] . "</li>";


echo "<li>Controls Accpeted: " .$sray[ControlsAccepted] . "</li>";


echo "<li>Win32 Exit Code: " .$sray[Win32ExitCode] . "</li>";


echo "<li>Service Specific Exit Code: " .$sray[ServiceSpecificExitCode] . "</li>";


echo "<li>Check Point: " .$sray[CheckPoint] . "</li>";


echo "<li>Wait Hint: " .$sray[WaitHint] . "</li>";


echo "<li>Process Id: " .$sray[ProcessId] . "</li>";


echo "<li>Service Flags: " .$sray[ServiceFlags] . "</li>";


?>

mnemotronic at netscape dot net
25-Oct-2006 02:30


If the service specified is non-existant, "win32_query_service_status" seems to return an integer, not  the expected FALSE value:





<?php


$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, 10 Jul 2009