base/system/services/services.h

   1 /*
   2  * services.h
   3  */
   4
   5 #ifndef _SERVICES_H
   6 #define _SERVICES_H
   7
   8 #include <stdio.h>
   9 #include <stdlib.h>
  10
  11 #define WIN32_NO_STATUS
  12 #define _INC_WINDOWS
  13 #define COM_NO_WINDOWS_H
  14
  15 #include <windef.h>
  16 #include <winbase.h>
  17 #include <winsvc.h>
  18 #include <winreg.h>
  19 #include <winuser.h>
  20 #include <netevent.h>
  21 #define NTOS_MODE_USER
  22 #include <ndk/setypes.h>
  23 #include <ndk/obfuncs.h>
  24 #include <ndk/rtlfuncs.h>
  25 #include <services/services.h>
  26 #include <svcctl_s.h>
  27
  28 #include "resource.h"
  29
  30 typedef struct _SERVICE_GROUP
  31 {
  32     LIST_ENTRY GroupListEntry;
  33     LPWSTR lpGroupName;
  34
  35     DWORD dwRefCount;
  36     BOOLEAN ServicesRunning;
  37     ULONG TagCount;
  38     PULONG TagArray;
  39
  40     WCHAR szGroupName[1];
  41 } SERVICE_GROUP, *PSERVICE_GROUP;
  42
  43
  44 typedef struct _SERVICE_IMAGE
  45 {
  46     LIST_ENTRY ImageListEntry;
  47     LPWSTR pszImagePath;
  48     LPWSTR pszAccountName;
  49     DWORD dwImageRunCount;
  50
  51     HANDLE hControlPipe;
  52     HANDLE hProcess;
  53     DWORD dwProcessId;
  54     HANDLE hToken;
  55     HANDLE hProfile;
  56 } SERVICE_IMAGE, *PSERVICE_IMAGE;
  57
  58
  59 typedef struct _SERVICE
  60 {
  61     LIST_ENTRY ServiceListEntry;
  62     LPWSTR lpServiceName;
  63     LPWSTR lpDisplayName;
  64     PSERVICE_GROUP lpGroup;
  65     PSERVICE_IMAGE lpImage;
  66     BOOL bDeleted;
  67     DWORD dwResumeCount;
  68     DWORD dwRefCount;
  69
  70     SERVICE_STATUS Status;
  71     DWORD dwStartType;
  72     DWORD dwErrorControl;
  73     DWORD dwTag;
  74
  75     DWORD dwServiceBits;
  76
  77     ULONG Flags;
  78
  79     PSECURITY_DESCRIPTOR pSecurityDescriptor;
  80
  81     BOOLEAN ServiceVisited;
  82
  83     WCHAR szServiceName[1];
  84 } SERVICE, *PSERVICE;
  85
  86
  87 #define LOCK_TAG 0x4C697041 /* 'ApiL' */
  88
  89 typedef struct _START_LOCK
  90 {
  91     DWORD Tag;             /* Must be LOCK_TAG */
  92     DWORD TimeWhenLocked;  /* Number of seconds since 1970 */
  93     PSID LockOwnerSid;     /* It is NULL if the SCM acquired the lock */
  94 } START_LOCK, *PSTART_LOCK;
  95
  96
  97 /* VARIABLES ***************************************************************/
  98
  99 extern LIST_ENTRY ServiceListHead;
 100 extern LIST_ENTRY GroupListHead;
 101 extern LIST_ENTRY ImageListHead;
 102 extern BOOL ScmInitialize;
 103 extern BOOL ScmShutdown;
 104 extern PSECURITY_DESCRIPTOR pPipeSD;
 105
 106
 107 /* FUNCTIONS ***************************************************************/
 108
 109 /* config.c */
 110
 111 DWORD ScmOpenServiceKey(LPWSTR lpServiceName,
 112                         REGSAM samDesired,
 113                         PHKEY phKey);
 114
 115 DWORD ScmCreateServiceKey(LPCWSTR lpServiceName,
 116                           REGSAM samDesired,
 117                           PHKEY phKey);
 118
 119 DWORD ScmWriteDependencies(HKEY hServiceKey,
 120                            LPCWSTR lpDependencies,
 121                            DWORD dwDependenciesLength);
 122
 123 DWORD ScmMarkServiceForDelete(PSERVICE pService);
 124 BOOL ScmIsDeleteFlagSet(HKEY hServiceKey);
 125
 126 DWORD ScmReadString(HKEY hServiceKey,
 127                     LPCWSTR lpValueName,
 128                     LPWSTR *lpValue);
 129
 130 DWORD
 131 ScmReadDependencies(HKEY hServiceKey,
 132                     LPWSTR *lpDependencies,
 133                     DWORD *lpdwDependenciesLength);
 134
 135 DWORD
 136 ScmSetServicePassword(
 137     IN PCWSTR pszServiceName,
 138     IN PCWSTR pszPassword);
 139
 140 DWORD
 141 ScmWriteSecurityDescriptor(
 142     _In_ HKEY hServiceKey,
 143     _In_ PSECURITY_DESCRIPTOR pSecurityDescriptor);
 144
 145 DWORD
 146 ScmReadSecurityDescriptor(
 147     _In_ HKEY hServiceKey,
 148     _Out_ PSECURITY_DESCRIPTOR *ppSecurityDescriptor);
 149
 150 DWORD
 151 ScmDeleteRegKey(
 152     _In_ HKEY hKey,
 153     _In_ PCWSTR pszSubKey);
 154
 155 DWORD
 156 ScmDecryptPassword(
 157     _In_ PBYTE pPassword,
 158     _In_ DWORD dwPasswordSize,
 159     _Out_ PWSTR *pDecryptedPassword);
 160
 161
 162 /* controlset.c */
 163
 164 DWORD
 165 ScmCreateLastKnownGoodControlSet(VOID);
 166
 167
 168 /* database.c */
 169
 170 DWORD ScmCreateServiceDatabase(VOID);
 171 VOID ScmShutdownServiceDatabase(VOID);
 172 VOID ScmGetBootAndSystemDriverState(VOID);
 173 VOID ScmAutoStartServices(VOID);
 174 VOID ScmAutoShutdownServices(VOID);
 175 DWORD ScmStartService(PSERVICE Service,
 176                       DWORD argc,
 177                       LPWSTR *argv);
 178
 179 VOID ScmRemoveServiceImage(PSERVICE_IMAGE pServiceImage);
 180 PSERVICE ScmGetServiceEntryByName(LPCWSTR lpServiceName);
 181 PSERVICE ScmGetServiceEntryByDisplayName(LPCWSTR lpDisplayName);
 182 PSERVICE ScmGetServiceEntryByResumeCount(DWORD dwResumeCount);
 183 DWORD ScmCreateNewServiceRecord(LPCWSTR lpServiceName,
 184                                 PSERVICE *lpServiceRecord,
 185                                 DWORD dwServiceType,
 186                                 DWORD dwStartType);
 187 VOID ScmDeleteServiceRecord(PSERVICE lpService);
 188 DWORD ScmMarkServiceForDelete(PSERVICE pService);
 189
 190 DWORD ScmControlService(HANDLE hControlPipe,
 191                         PWSTR pServiceName,
 192                         SERVICE_STATUS_HANDLE hServiceStatus,
 193                         DWORD dwControl);
 194
 195 BOOL ScmLockDatabaseExclusive(VOID);
 196 BOOL ScmLockDatabaseShared(VOID);
 197 VOID ScmUnlockDatabase(VOID);
 198
 199 VOID ScmInitNamedPipeCriticalSection(VOID);
 200 VOID ScmDeleteNamedPipeCriticalSection(VOID);
 201
 202 DWORD ScmGetServiceNameFromTag(PTAG_INFO_NAME_FROM_TAG_IN_PARAMS InParams,
 203                                PTAG_INFO_NAME_FROM_TAG_OUT_PARAMS *OutParams);
 204
 205 DWORD ScmGenerateServiceTag(PSERVICE lpServiceRecord);
 206
 207 /* driver.c */
 208
 209 DWORD ScmStartDriver(PSERVICE lpService);
 210 DWORD ScmControlDriver(PSERVICE lpService,
 211                        DWORD dwControl,
 212                        LPSERVICE_STATUS lpServiceStatus);
 213
 214
 215 /* groupdb.c */
 216
 217 PSERVICE_GROUP
 218 ScmGetServiceGroupByName(
 219     _In_ LPCWSTR lpGroupName);
 220
 221 DWORD ScmCreateGroupList(VOID);
 222 DWORD ScmSetServiceGroup(PSERVICE lpService,
 223                          LPCWSTR lpGroupName);
 224
 225
 226 /* lock.c */
 227
 228 DWORD ScmAcquireServiceStartLock(IN BOOL IsServiceController,
 229                                  OUT LPSC_RPC_LOCK lpLock);
 230 DWORD ScmReleaseServiceStartLock(IN OUT LPSC_RPC_LOCK lpLock);
 231 VOID ScmQueryServiceLockStatusW(OUT LPQUERY_SERVICE_LOCK_STATUSW lpLockStatus);
 232 VOID ScmQueryServiceLockStatusA(OUT LPQUERY_SERVICE_LOCK_STATUSA lpLockStatus);
 233
 234
 235 /* rpcserver.c */
 236
 237 VOID ScmStartRpcServer(VOID);
 238
 239
 240 /* security.c */
 241
 242 DWORD ScmInitializeSecurity(VOID);
 243 VOID ScmShutdownSecurity(VOID);
 244
 245 DWORD
 246 ScmCreateDefaultServiceSD(
 247     PSECURITY_DESCRIPTOR *ppSecurityDescriptor);
 248
 249
 250 /* services.c */
 251
 252 VOID PrintString(LPCSTR fmt, ...);
 253 VOID ScmLogEvent(DWORD dwEventId,
 254                  WORD wType,
 255                  WORD wStrings,
 256                  LPCWSTR *lpStrings);
 257 VOID ScmWaitForLsa(VOID);
 258
 259 #endif /* _SERVICES_H */