include/winsvc.h

   1 /**
   2  * @file winsvc.h
   3  * Copyright 2012, 2013 MinGW.org project
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the next
  13  * paragraph) shall be included in all copies or substantial portions of the
  14  * Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  22  * DEALINGS IN THE SOFTWARE.
  23  */
  24 #ifndef _WINSVC_H
  25 #define _WINSVC_H
  26 #pragma GCC system_header
  27 #include <_mingw.h>
  28
  29 #ifndef WINADVAPI
  30 #define WINADVAPI
  31 #endif
  32
  33 #ifdef __cplusplus
  34 extern "C" {
  35 #endif
  36
  37 #define SERVICES_ACTIVE_DATABASEA "ServicesActive"
  38 #define SERVICES_ACTIVE_DATABASEW L"ServicesActive"
  39 #define SERVICES_FAILED_DATABASEA "ServicesFailed"
  40 #define SERVICES_FAILED_DATABASEW L"ServicesFailed"
  41 #define SC_GROUP_IDENTIFIERA '+'
  42 #define SC_GROUP_IDENTIFIERW L'+'
  43 #define SC_MANAGER_ALL_ACCESS   0xf003f
  44 #define SC_MANAGER_CONNECT      1
  45 #define SC_MANAGER_CREATE_SERVICE       2
  46 #define SC_MANAGER_ENUMERATE_SERVICE    4
  47 #define SC_MANAGER_LOCK 8
  48 #define SC_MANAGER_QUERY_LOCK_STATUS    16
  49 #define SC_MANAGER_MODIFY_BOOT_CONFIG   32
  50 #define SERVICE_NO_CHANGE 0xffffffff
  51 #define SERVICE_STOPPED 1
  52 #define SERVICE_START_PENDING   2
  53 #define SERVICE_STOP_PENDING    3
  54 #define SERVICE_RUNNING 4
  55 #define SERVICE_CONTINUE_PENDING        5
  56 #define SERVICE_PAUSE_PENDING   6
  57 #define SERVICE_PAUSED  7
  58 #define SERVICE_ACCEPT_STOP     1
  59 #define SERVICE_ACCEPT_PAUSE_CONTINUE   2
  60 #define SERVICE_ACCEPT_SHUTDOWN 4
  61 #define SERVICE_ACCEPT_PARAMCHANGE    8
  62 #define SERVICE_ACCEPT_NETBINDCHANGE  16
  63 #define SERVICE_ACCEPT_HARDWAREPROFILECHANGE   32
  64 #define SERVICE_ACCEPT_POWEREVENT              64
  65 #define SERVICE_ACCEPT_SESSIONCHANGE           128
  66 #define SERVICE_CONTROL_STOP    1
  67 #define SERVICE_CONTROL_PAUSE   2
  68 #define SERVICE_CONTROL_CONTINUE        3
  69 #define SERVICE_CONTROL_INTERROGATE     4
  70 #define SERVICE_CONTROL_SHUTDOWN        5
  71 #define SERVICE_CONTROL_PARAMCHANGE     6
  72 #define SERVICE_CONTROL_NETBINDADD      7
  73 #define SERVICE_CONTROL_NETBINDREMOVE   8
  74 #define SERVICE_CONTROL_NETBINDENABLE   9
  75 #define SERVICE_CONTROL_NETBINDDISABLE  10
  76 #define SERVICE_CONTROL_DEVICEEVENT     11
  77 #define SERVICE_CONTROL_HARDWAREPROFILECHANGE 12
  78 #define SERVICE_CONTROL_POWEREVENT            13
  79 #define SERVICE_CONTROL_SESSIONCHANGE         14
  80 #define SERVICE_ACTIVE 1
  81 #define SERVICE_INACTIVE 2
  82 #define SERVICE_STATE_ALL 3
  83 #define SERVICE_QUERY_CONFIG 1
  84 #define SERVICE_CHANGE_CONFIG 2
  85 #define SERVICE_QUERY_STATUS 4
  86 #define SERVICE_ENUMERATE_DEPENDENTS 8
  87 #define SERVICE_START 16
  88 #define SERVICE_STOP 32
  89 #define SERVICE_PAUSE_CONTINUE 64
  90 #define SERVICE_INTERROGATE 128
  91 #define SERVICE_USER_DEFINED_CONTROL 256
  92 #define SERVICE_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED|SERVICE_QUERY_CONFIG|SERVICE_CHANGE_CONFIG|SERVICE_QUERY_STATUS|SERVICE_ENUMERATE_DEPENDENTS|SERVICE_START|SERVICE_STOP|SERVICE_PAUSE_CONTINUE|SERVICE_INTERROGATE|SERVICE_USER_DEFINED_CONTROL)
  93 #define SERVICE_RUNS_IN_SYSTEM_PROCESS 1
  94 #define SERVICE_CONFIG_DESCRIPTION     1
  95 #define SERVICE_CONFIG_FAILURE_ACTIONS 2
  96
  97 typedef struct _SERVICE_STATUS {
  98         DWORD dwServiceType;
  99         DWORD dwCurrentState;
 100         DWORD dwControlsAccepted;
 101         DWORD dwWin32ExitCode;
 102         DWORD dwServiceSpecificExitCode;
 103         DWORD dwCheckPoint;
 104         DWORD dwWaitHint;
 105 } SERVICE_STATUS,*LPSERVICE_STATUS;
 106 typedef struct _SERVICE_STATUS_PROCESS {
 107         DWORD dwServiceType;
 108         DWORD dwCurrentState;
 109         DWORD dwControlsAccepted;
 110         DWORD dwWin32ExitCode;
 111         DWORD dwServiceSpecificExitCode;
 112         DWORD dwCheckPoint;
 113         DWORD dwWaitHint;
 114         DWORD dwProcessId;
 115         DWORD dwServiceFlags;
 116 } SERVICE_STATUS_PROCESS, *LPSERVICE_STATUS_PROCESS;
 117 typedef enum _SC_STATUS_TYPE {
 118         SC_STATUS_PROCESS_INFO = 0
 119 } SC_STATUS_TYPE;
 120 typedef enum _SC_ENUM_TYPE {
 121         SC_ENUM_PROCESS_INFO = 0
 122 } SC_ENUM_TYPE;
 123 typedef struct _ENUM_SERVICE_STATUSA {
 124         LPSTR lpServiceName;
 125         LPSTR lpDisplayName;
 126         SERVICE_STATUS ServiceStatus;
 127 } ENUM_SERVICE_STATUSA,*LPENUM_SERVICE_STATUSA;
 128 typedef struct _ENUM_SERVICE_STATUSW {
 129         LPWSTR lpServiceName;
 130         LPWSTR lpDisplayName;
 131         SERVICE_STATUS ServiceStatus;
 132 } ENUM_SERVICE_STATUSW,*LPENUM_SERVICE_STATUSW;
 133 typedef struct _ENUM_SERVICE_STATUS_PROCESSA {
 134         LPSTR lpServiceName;
 135         LPSTR lpDisplayName;
 136         SERVICE_STATUS_PROCESS ServiceStatusProcess;
 137 } ENUM_SERVICE_STATUS_PROCESSA,*LPENUM_SERVICE_STATUS_PROCESSA;
 138 typedef struct _ENUM_SERVICE_STATUS_PROCESSW {
 139         LPWSTR lpServiceName;
 140         LPWSTR lpDisplayName;
 141         SERVICE_STATUS_PROCESS ServiceStatusProcess;
 142 } ENUM_SERVICE_STATUS_PROCESSW,*LPENUM_SERVICE_STATUS_PROCESSW;
 143 typedef struct _QUERY_SERVICE_CONFIGA {
 144         DWORD dwServiceType;
 145         DWORD dwStartType;
 146         DWORD dwErrorControl;
 147         LPSTR lpBinaryPathName;
 148         LPSTR lpLoadOrderGroup;
 149         DWORD dwTagId;
 150         LPSTR lpDependencies;
 151         LPSTR lpServiceStartName;
 152         LPSTR lpDisplayName;
 153 } QUERY_SERVICE_CONFIGA,*LPQUERY_SERVICE_CONFIGA;
 154 typedef struct _QUERY_SERVICE_CONFIGW {
 155         DWORD dwServiceType;
 156         DWORD dwStartType;
 157         DWORD dwErrorControl;
 158         LPWSTR lpBinaryPathName;
 159         LPWSTR lpLoadOrderGroup;
 160         DWORD dwTagId;
 161         LPWSTR lpDependencies;
 162         LPWSTR lpServiceStartName;
 163         LPWSTR lpDisplayName;
 164 } QUERY_SERVICE_CONFIGW,*LPQUERY_SERVICE_CONFIGW;
 165 typedef struct _QUERY_SERVICE_LOCK_STATUSA {
 166         DWORD fIsLocked;
 167         LPSTR lpLockOwner;
 168         DWORD dwLockDuration;
 169 } QUERY_SERVICE_LOCK_STATUSA,*LPQUERY_SERVICE_LOCK_STATUSA;
 170 typedef struct _QUERY_SERVICE_LOCK_STATUSW {
 171         DWORD fIsLocked;
 172         LPWSTR lpLockOwner;
 173         DWORD dwLockDuration;
 174 } QUERY_SERVICE_LOCK_STATUSW,*LPQUERY_SERVICE_LOCK_STATUSW;
 175 typedef void (WINAPI *LPSERVICE_MAIN_FUNCTIONA)(DWORD,LPSTR*);
 176 typedef void (WINAPI *LPSERVICE_MAIN_FUNCTIONW)(DWORD,LPWSTR*);
 177 typedef struct _SERVICE_TABLE_ENTRYA {
 178         LPSTR lpServiceName;
 179         LPSERVICE_MAIN_FUNCTIONA lpServiceProc;
 180 } SERVICE_TABLE_ENTRYA,*LPSERVICE_TABLE_ENTRYA;
 181 typedef struct _SERVICE_TABLE_ENTRYW {
 182         LPWSTR lpServiceName;
 183         LPSERVICE_MAIN_FUNCTIONW lpServiceProc;
 184 } SERVICE_TABLE_ENTRYW,*LPSERVICE_TABLE_ENTRYW;
 185 DECLARE_HANDLE(SC_HANDLE);
 186 typedef SC_HANDLE *LPSC_HANDLE;
 187 typedef PVOID SC_LOCK;
 188 typedef DWORD SERVICE_STATUS_HANDLE;
 189 typedef VOID(WINAPI *LPHANDLER_FUNCTION)(DWORD);
 190 typedef DWORD (WINAPI *LPHANDLER_FUNCTION_EX)(DWORD,DWORD,LPVOID,LPVOID);
 191 typedef struct _SERVICE_DESCRIPTIONA {
 192         LPSTR lpDescription;
 193 } SERVICE_DESCRIPTIONA,*LPSERVICE_DESCRIPTIONA;
 194 typedef struct _SERVICE_DESCRIPTIONW {
 195         LPWSTR lpDescription;
 196 } SERVICE_DESCRIPTIONW,*LPSERVICE_DESCRIPTIONW;
 197 typedef enum _SC_ACTION_TYPE {
 198         SC_ACTION_NONE          = 0,
 199         SC_ACTION_RESTART       = 1,
 200         SC_ACTION_REBOOT        = 2,
 201         SC_ACTION_RUN_COMMAND   = 3
 202 } SC_ACTION_TYPE;
 203 typedef struct _SC_ACTION {
 204         SC_ACTION_TYPE  Type;
 205         DWORD           Delay;
 206 } SC_ACTION,*LPSC_ACTION;
 207 typedef struct _SERVICE_FAILURE_ACTIONSA {
 208         DWORD   dwResetPeriod;
 209         LPSTR   lpRebootMsg;
 210         LPSTR   lpCommand;
 211         DWORD   cActions;
 212         SC_ACTION * lpsaActions;
 213 } SERVICE_FAILURE_ACTIONSA,*LPSERVICE_FAILURE_ACTIONSA;
 214 typedef struct _SERVICE_FAILURE_ACTIONSW {
 215         DWORD   dwResetPeriod;
 216         LPWSTR  lpRebootMsg;
 217         LPWSTR  lpCommand;
 218         DWORD   cActions;
 219         SC_ACTION * lpsaActions;
 220 } SERVICE_FAILURE_ACTIONSW,*LPSERVICE_FAILURE_ACTIONSW;
 221
 222 WINADVAPI BOOL WINAPI ChangeServiceConfigA(SC_HANDLE,DWORD,DWORD,DWORD,LPCSTR,LPCSTR,LPDWORD,LPCSTR,LPCSTR,LPCSTR,LPCSTR);
 223 WINADVAPI BOOL WINAPI ChangeServiceConfigW(SC_HANDLE,DWORD,DWORD,DWORD,LPCWSTR,LPCWSTR,LPDWORD,LPCWSTR,LPCWSTR,LPCWSTR,LPCWSTR);
 224 WINADVAPI BOOL WINAPI ChangeServiceConfig2A(SC_HANDLE,DWORD,LPVOID);
 225 WINADVAPI BOOL WINAPI ChangeServiceConfig2W(SC_HANDLE,DWORD,LPVOID);
 226 WINADVAPI BOOL WINAPI CloseServiceHandle(SC_HANDLE);
 227 WINADVAPI BOOL WINAPI ControlService(SC_HANDLE,DWORD,LPSERVICE_STATUS);
 228 WINADVAPI SC_HANDLE WINAPI CreateServiceA(SC_HANDLE,LPCSTR,LPCSTR,DWORD,DWORD,DWORD,DWORD,LPCSTR,LPCSTR,PDWORD,LPCSTR,LPCSTR,LPCSTR);
 229 WINADVAPI SC_HANDLE WINAPI CreateServiceW(SC_HANDLE,LPCWSTR,LPCWSTR,DWORD,DWORD,DWORD,DWORD,LPCWSTR,LPCWSTR,PDWORD,LPCWSTR,LPCWSTR,LPCWSTR);
 230 WINADVAPI BOOL WINAPI DeleteService(SC_HANDLE);
 231 WINADVAPI BOOL WINAPI EnumDependentServicesA(SC_HANDLE,DWORD,LPENUM_SERVICE_STATUSA,DWORD,PDWORD,PDWORD);
 232 WINADVAPI BOOL WINAPI EnumDependentServicesW(SC_HANDLE,DWORD,LPENUM_SERVICE_STATUSW,DWORD,PDWORD,PDWORD);
 233 WINADVAPI BOOL WINAPI EnumServicesStatusA(SC_HANDLE,DWORD,DWORD,LPENUM_SERVICE_STATUSA,DWORD,PDWORD,PDWORD,PDWORD);
 234 WINADVAPI BOOL WINAPI EnumServicesStatusW(SC_HANDLE,DWORD,DWORD,LPENUM_SERVICE_STATUSW,DWORD,PDWORD,PDWORD,PDWORD);
 235 WINADVAPI BOOL WINAPI EnumServicesStatusExA(SC_HANDLE,SC_ENUM_TYPE,DWORD,DWORD,LPBYTE,DWORD,LPDWORD,LPDWORD,LPDWORD,LPCSTR);
 236 WINADVAPI BOOL WINAPI EnumServicesStatusExW(SC_HANDLE,SC_ENUM_TYPE,DWORD,DWORD,LPBYTE,DWORD,LPDWORD,LPDWORD,LPDWORD,LPCWSTR);
 237 WINADVAPI BOOL WINAPI GetServiceDisplayNameA(SC_HANDLE,LPCSTR,LPSTR,PDWORD);
 238 WINADVAPI BOOL WINAPI GetServiceDisplayNameW(SC_HANDLE,LPCWSTR,LPWSTR,PDWORD);
 239 WINADVAPI BOOL WINAPI GetServiceKeyNameA(SC_HANDLE,LPCSTR,LPSTR,PDWORD);
 240 WINADVAPI BOOL WINAPI GetServiceKeyNameW(SC_HANDLE,LPCWSTR,LPWSTR,PDWORD);
 241 WINADVAPI SC_LOCK WINAPI LockServiceDatabase(SC_HANDLE);
 242 WINADVAPI BOOL WINAPI NotifyBootConfigStatus(BOOL);
 243 WINADVAPI SC_HANDLE WINAPI OpenSCManagerA(LPCSTR,LPCSTR,DWORD);
 244 WINADVAPI SC_HANDLE WINAPI OpenSCManagerW(LPCWSTR,LPCWSTR,DWORD);
 245 WINADVAPI SC_HANDLE WINAPI OpenServiceA(SC_HANDLE,LPCSTR,DWORD);
 246 WINADVAPI SC_HANDLE WINAPI OpenServiceW(SC_HANDLE,LPCWSTR,DWORD);
 247 WINADVAPI BOOL WINAPI QueryServiceConfigA(SC_HANDLE,LPQUERY_SERVICE_CONFIGA,DWORD,PDWORD);
 248 WINADVAPI BOOL WINAPI QueryServiceConfigW(SC_HANDLE,LPQUERY_SERVICE_CONFIGW,DWORD,PDWORD);
 249 WINADVAPI BOOL WINAPI QueryServiceConfig2A(SC_HANDLE,DWORD,LPBYTE,DWORD,LPDWORD);
 250 WINADVAPI BOOL WINAPI QueryServiceConfig2W(SC_HANDLE,DWORD,LPBYTE,DWORD,LPDWORD);
 251 WINADVAPI BOOL WINAPI QueryServiceLockStatusA(SC_HANDLE,LPQUERY_SERVICE_LOCK_STATUSA,DWORD,PDWORD);
 252 WINADVAPI BOOL WINAPI QueryServiceLockStatusW(SC_HANDLE,LPQUERY_SERVICE_LOCK_STATUSW,DWORD,PDWORD);
 253 WINADVAPI BOOL WINAPI QueryServiceObjectSecurity(SC_HANDLE,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR,DWORD,LPDWORD);
 254 WINADVAPI BOOL WINAPI QueryServiceStatus(SC_HANDLE,LPSERVICE_STATUS);
 255 WINADVAPI BOOL WINAPI QueryServiceStatusEx(SC_HANDLE,SC_STATUS_TYPE,LPBYTE,DWORD,LPDWORD);
 256 WINADVAPI SERVICE_STATUS_HANDLE WINAPI RegisterServiceCtrlHandlerA(LPCSTR,LPHANDLER_FUNCTION);
 257 WINADVAPI SERVICE_STATUS_HANDLE WINAPI RegisterServiceCtrlHandlerW(LPCWSTR,LPHANDLER_FUNCTION);
 258 WINADVAPI SERVICE_STATUS_HANDLE WINAPI RegisterServiceCtrlHandlerExA(LPCSTR,LPHANDLER_FUNCTION_EX,LPVOID);
 259 WINADVAPI SERVICE_STATUS_HANDLE WINAPI RegisterServiceCtrlHandlerExW(LPCWSTR,LPHANDLER_FUNCTION_EX,LPVOID);
 260 WINADVAPI BOOL WINAPI SetServiceObjectSecurity(SC_HANDLE,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR);
 261 WINADVAPI BOOL WINAPI SetServiceStatus(SERVICE_STATUS_HANDLE,LPSERVICE_STATUS);
 262 WINADVAPI BOOL WINAPI StartServiceA(SC_HANDLE,DWORD,LPCSTR*);
 263 WINADVAPI BOOL WINAPI StartServiceCtrlDispatcherA(LPSERVICE_TABLE_ENTRYA);
 264 WINADVAPI BOOL WINAPI StartServiceCtrlDispatcherW(LPSERVICE_TABLE_ENTRYW);
 265 WINADVAPI BOOL WINAPI StartServiceW(SC_HANDLE,DWORD,LPCWSTR*);
 266 WINADVAPI BOOL WINAPI UnlockServiceDatabase(SC_LOCK);
 267
 268 typedef __AW(ENUM_SERVICE_STATUS) ENUM_SERVICE_STATUS,*LPENUM_SERVICE_STATUS;
 269 typedef __AW(ENUM_SERVICE_STATUS_PROCESS) ENUM_SERVICE_STATUS_PROCESS;
 270 typedef __AW(LPENUM_SERVICE_STATUS_PROCESS) LPENUM_SERVICE_STATUS_PROCESS;
 271 typedef __AW(QUERY_SERVICE_CONFIG) QUERY_SERVICE_CONFIG,*LPQUERY_SERVICE_CONFIG;
 272 typedef __AW(QUERY_SERVICE_LOCK_STATUS) QUERY_SERVICE_LOCK_STATUS,*LPQUERY_SERVICE_LOCK_STATUS;
 273 typedef __AW(SERVICE_TABLE_ENTRY) SERVICE_TABLE_ENTRY,*LPSERVICE_TABLE_ENTRY;
 274 typedef __AW(LPSERVICE_MAIN_FUNCTION) LPSERVICE_MAIN_FUNCTION;
 275 typedef __AW(SERVICE_DESCRIPTION) SERVICE_DESCRIPTION;
 276 typedef __AW(LPSERVICE_DESCRIPTION) LPSERVICE_DESCRIPTION;
 277 typedef __AW(SERVICE_FAILURE_ACTIONS) SERVICE_FAILURE_ACTIONS;
 278 typedef __AW(LPSERVICE_FAILURE_ACTIONS) LPSERVICE_FAILURE_ACTIONS;
 279 #define SERVICES_ACTIVE_DATABASE __AW(SERVICES_ACTIVE_DATABASE)
 280 #define SERVICES_FAILED_DATABASE __AW(SERVICES_FAILED_DATABASE)
 281 #define SC_GROUP_IDENTIFIER __AW(SC_GROUP_IDENTIFIER)
 282 #define ChangeServiceConfig __AW(ChangeServiceConfig)
 283 #define ChangeServiceConfig2 __AW(ChangeServiceConfig2)
 284 #define CreateService __AW(CreateService)
 285 #define EnumDependentServices __AW(EnumDependentServices)
 286 #define EnumServicesStatus __AW(EnumServicesStatus)
 287 #define EnumServicesStatusEx  __AW(EnumServicesStatusEx)
 288 #define GetServiceDisplayName __AW(GetServiceDisplayName)
 289 #define GetServiceKeyName __AW(GetServiceKeyName)
 290 #define OpenSCManager __AW(OpenSCManager)
 291 #define OpenService __AW(OpenService)
 292 #define QueryServiceConfig __AW(QueryServiceConfig)
 293 #define QueryServiceConfig2 __AW(QueryServiceConfig2)
 294 #define QueryServiceLockStatus __AW(QueryServiceLockStatus)
 295 #define RegisterServiceCtrlHandler __AW(RegisterServiceCtrlHandler)
 296 #define RegisterServiceCtrlHandlerEx __AW(RegisterServiceCtrlHandlerEx)
 297 #define StartService __AW(StartService)
 298 #define StartServiceCtrlDispatcher __AW(StartServiceCtrlDispatcher)
 299
 300 #ifdef __cplusplus
 301 }
 302 #endif
 303
 304 #endif /* _WINSVC_H */