サービスの状態を問い合わせる

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

サービスの稼動状況を問い合わせ、情報を配列で返します。

成功した場合に以下の情報を含む配列を返します。パラメータに問題がある場合は FALSE、失敗した場合は Win32 エラーコードを返します。

ServiceType: dwServiceType Win32Service サービス型のビットマスクを参照ください。
CurrentState: dwCurrentState Win32Service サービスステータス定数を参照ください。
ControlsAccepted: サービスが許可しているコントロール。 Win32Service サービス制御メッセージが受領されたときのビットマスクを参照ください。
Win32ExitCode: サービスが終了した際にプロセスが返すコード。
ServiceSpecificExitCode: サービスが異常終了した際にイベントログに記録されるコード。
CheckPoint: サービスが終了する際に、現在のチェックポイント番号を保持します。 SCM はこれをいわゆる心拍のように扱い、反応しなくなったサービスを検出するために使用します。この値は、WaitHint の値と組み合わせて用いられます。
WaitHint: サービスが終了する際に、WaitHint を checkpoint の値に設定します。この処理が終了した時点でサービスの終了処理が 100% 完了したことを示します。これは、進捗状況のインジケータを実装する際に使用します。
ProcessId: Windows のプロセス ID 。0 の場合、プロセスは実行していません。
ServiceFlags: dwServiceFlags Win32Service サービスフラグ定数を参照ください。