SERVICE_STATUS_PROCESS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwServiceType | ENUM_SERVICE_TYPE | 4 | +0 | +0 | サービスの種類です。このメンバーには次のいずれかの値を指定できます。
サービスの種類が SERVICE_WIN32_OWN_PROCESS または SERVICE_WIN32_SHARE_PROCESS であり、そのサービスが LocalSystem アカウントのコンテキストで実行されている場合は、次の種類も指定できます。
| ||||||||||||||||||||||
| dwCurrentState | SERVICE_STATUS_CURRENT_STATE | 4 | +4 | +4 | サービスの現在の状態です。このメンバーには次のいずれかの値を指定できます。
| ||||||||||||||||||||||
| dwControlsAccepted | DWORD | 4 | +8 | +8 | サービスがハンドラー関数で受け入れて処理する制御コードです ( Handler および HandlerEx を参照)。ユーザー インターフェイス プロセスは、 ControlService 関数または ControlServiceEx 関数で制御コマンドを指定することにより、サービスを制御できます。既定では、すべてのサービスが SERVICE_CONTROL_INTERROGATE の値を受け入れます。 制御コードは次のとおりです。
このメンバーには、 HandlerEx でのみサポートされる次の拡張制御コードを含めることもできます。(これらの制御コードは ControlService や ControlServiceEx では送信できないことに注意してください。)
| ||||||||||||||||||||||
| dwWin32ExitCode | DWORD | 4 | +12 | +12 | サービスの開始時または停止時に発生したエラーを報告するために、サービスが使用するエラー コードです。サービス固有のエラー コードを返すには、dwServiceSpecificExitCode メンバーにエラー コードが格納されていることを示すため、サービスはこの値を ERROR_SERVICE_SPECIFIC_ERROR に設定する必要があります。サービスは、実行中および正常に終了する場合には、この値を NO_ERROR に設定します。 | ||||||||||||||||||||||
| dwServiceSpecificExitCode | DWORD | 4 | +16 | +16 | サービスの開始中または停止中にエラーが発生したときに、サービスが返すサービス固有のエラー コードです。dwWin32ExitCode メンバーが ERROR_SERVICE_SPECIFIC_ERROR に設定されている場合を除き、この値は無視されます。 | ||||||||||||||||||||||
| dwCheckPoint | DWORD | 4 | +20 | +20 | 時間のかかる開始、停止、一時停止、または再開の操作中に、進行状況を報告するためにサービスが定期的にインクリメントするチェックポイント値です。たとえば、起動時にサービスは初期化の各ステップを完了するたびにこの値をインクリメントします。サービスに対して操作を実行したユーザー インターフェイス プログラムは、この値を使用して、時間のかかる操作中のサービスの進行状況を追跡します。開始、停止、一時停止、または再開の操作が保留中でない場合、この値は無効であり、0 でなければなりません。 | ||||||||||||||||||||||
| dwWaitHint | DWORD | 4 | +24 | +24 | 保留中の開始、停止、一時停止、または再開の操作に必要と見積もられる時間 (ミリ秒単位) です。サービスは、指定された時間が経過する前に、インクリメントした dwCheckPoint 値、または変更した dwCurrentState 値を指定して、 SetServiceStatus 関数を次に呼び出す必要があります。dwWaitHint で指定された時間が経過しても dwCheckPoint がインクリメントされず、dwCurrentState も変化しない場合、サービス コントロール マネージャーまたはサービス制御プログラムは、エラーが発生したものとみなしてサービスを停止できます。ただし、サービスが他のサービスとプロセスを共有している場合、そのプロセスを共有する他のサービスも終了させることになるため、サービス コントロール マネージャーはサービス アプリケーションを終了できません。 | ||||||||||||||||||||||
| dwProcessId | DWORD | 4 | +28 | +28 | サービスのプロセス識別子です。 | ||||||||||||||||||||||
| dwServiceFlags | SERVICE_RUNS_IN_PROCESS | 4 | +32 | +32 | このメンバーには次のいずれかの値を指定できます。
|
公式ドキュメント
サービスのプロセス状態情報を格納します。 ControlServiceEx、EnumServicesStatusEx、NotifyServiceStatusChange、 QueryServiceStatusEx の各関数がこの構造体を使用します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SERVICE_STATUS_PROCESS (x64 36 / x86 36 バイト)
typedef struct SERVICE_STATUS_PROCESS {
ENUM_SERVICE_TYPE dwServiceType;
SERVICE_STATUS_CURRENT_STATE dwCurrentState;
DWORD dwControlsAccepted;
DWORD dwWin32ExitCode;
DWORD dwServiceSpecificExitCode;
DWORD dwCheckPoint;
DWORD dwWaitHint;
DWORD dwProcessId;
SERVICE_RUNS_IN_PROCESS dwServiceFlags;
} SERVICE_STATUS_PROCESS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SERVICE_STATUS_PROCESS
{
public uint dwServiceType;
public uint dwCurrentState;
public uint dwControlsAccepted;
public uint dwWin32ExitCode;
public uint dwServiceSpecificExitCode;
public uint dwCheckPoint;
public uint dwWaitHint;
public uint dwProcessId;
public uint dwServiceFlags;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SERVICE_STATUS_PROCESS
Public dwServiceType As UInteger
Public dwCurrentState As UInteger
Public dwControlsAccepted As UInteger
Public dwWin32ExitCode As UInteger
Public dwServiceSpecificExitCode As UInteger
Public dwCheckPoint As UInteger
Public dwWaitHint As UInteger
Public dwProcessId As UInteger
Public dwServiceFlags As UInteger
End Structureimport ctypes
from ctypes import wintypes
class SERVICE_STATUS_PROCESS(ctypes.Structure):
_fields_ = [
("dwServiceType", wintypes.DWORD),
("dwCurrentState", wintypes.DWORD),
("dwControlsAccepted", wintypes.DWORD),
("dwWin32ExitCode", wintypes.DWORD),
("dwServiceSpecificExitCode", wintypes.DWORD),
("dwCheckPoint", wintypes.DWORD),
("dwWaitHint", wintypes.DWORD),
("dwProcessId", wintypes.DWORD),
("dwServiceFlags", wintypes.DWORD),
]#[repr(C)]
pub struct SERVICE_STATUS_PROCESS {
pub dwServiceType: u32,
pub dwCurrentState: u32,
pub dwControlsAccepted: u32,
pub dwWin32ExitCode: u32,
pub dwServiceSpecificExitCode: u32,
pub dwCheckPoint: u32,
pub dwWaitHint: u32,
pub dwProcessId: u32,
pub dwServiceFlags: u32,
}import "golang.org/x/sys/windows"
type SERVICE_STATUS_PROCESS struct {
dwServiceType uint32
dwCurrentState uint32
dwControlsAccepted uint32
dwWin32ExitCode uint32
dwServiceSpecificExitCode uint32
dwCheckPoint uint32
dwWaitHint uint32
dwProcessId uint32
dwServiceFlags uint32
}type
SERVICE_STATUS_PROCESS = record
dwServiceType: DWORD;
dwCurrentState: DWORD;
dwControlsAccepted: DWORD;
dwWin32ExitCode: DWORD;
dwServiceSpecificExitCode: DWORD;
dwCheckPoint: DWORD;
dwWaitHint: DWORD;
dwProcessId: DWORD;
dwServiceFlags: DWORD;
end;const SERVICE_STATUS_PROCESS = extern struct {
dwServiceType: u32,
dwCurrentState: u32,
dwControlsAccepted: u32,
dwWin32ExitCode: u32,
dwServiceSpecificExitCode: u32,
dwCheckPoint: u32,
dwWaitHint: u32,
dwProcessId: u32,
dwServiceFlags: u32,
};type
SERVICE_STATUS_PROCESS {.bycopy.} = object
dwServiceType: uint32
dwCurrentState: uint32
dwControlsAccepted: uint32
dwWin32ExitCode: uint32
dwServiceSpecificExitCode: uint32
dwCheckPoint: uint32
dwWaitHint: uint32
dwProcessId: uint32
dwServiceFlags: uint32struct SERVICE_STATUS_PROCESS
{
uint dwServiceType;
uint dwCurrentState;
uint dwControlsAccepted;
uint dwWin32ExitCode;
uint dwServiceSpecificExitCode;
uint dwCheckPoint;
uint dwWaitHint;
uint dwProcessId;
uint dwServiceFlags;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SERVICE_STATUS_PROCESS サイズ: 36 バイト(x64)
dim st, 9 ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; dwServiceType : ENUM_SERVICE_TYPE (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwCurrentState : SERVICE_STATUS_CURRENT_STATE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwControlsAccepted : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwWin32ExitCode : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; dwServiceSpecificExitCode : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwCheckPoint : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; dwWaitHint : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; dwProcessId : DWORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; dwServiceFlags : SERVICE_RUNS_IN_PROCESS (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SERVICE_STATUS_PROCESS
#field int dwServiceType
#field int dwCurrentState
#field int dwControlsAccepted
#field int dwWin32ExitCode
#field int dwServiceSpecificExitCode
#field int dwCheckPoint
#field int dwWaitHint
#field int dwProcessId
#field int dwServiceFlags
#endstruct
stdim st, SERVICE_STATUS_PROCESS ; NSTRUCT 変数を確保
st->dwServiceType = 100
mes "dwServiceType=" + st->dwServiceType