win32_query_service_status
win32_query_service_status — サービスの状態を問い合わせる
説明
mixed win32_query_service_status ( string servicename [, string machine] )サービスの稼動状況を問い合わせ、情報を配列で返します。
パラメータ
- servicename
-
サービスの短い名前。
- machine
-
オプションのマシン名。指定しなかった場合、ローカルマシンが使用されます。
返り値
失敗した場合に FALSE 、それ以外の場合に以下の情報を含む配列を返します。- ServiceType
-
dwServiceType
- CurrentState
-
dwCurrentState
- ControlsAccepted
-
サービスが許可しているコントロール。
- Win32ExitCode
-
サービスが終了した際にプロセスが返すコード。
- ServiceSpecificExitCode
-
サービスが異常終了した際にイベントログに記録されるコード。
- CheckPoint
-
サービスが終了する際に、現在のチェックポイント番号を保持します。
SCM はこれをいわゆる心拍のように扱い、反応しなくなったサービスを
検出するために使用します。この値は、WaitHint の値と組み合わせて
用いられます。
- WaitHint
-
サービスが終了する際に、WaitHint を checkpoint の値に設定します。
この処理が終了した時点でサービスの終了処理が 100% 完了したことを示します。
これは、進捗状況のインジケータを実装する際に使用します。
- ProcessId
-
Windows のプロセス ID 。0 の場合、プロセスは実行していません。
- ServiceFlags
-
dwServiceFlags
- win32_query_service_statusのページへのリンク