1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
|
/*********************************************************
* Copyright (C) 1998 VMware, Inc. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published
* by the Free Software Foundation version 2.1 and no later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the Lesser GNU General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
*********************************************************/
/*
* Win32Util.h --
*
* misc Windows utilities
*/
#ifndef WIN32UTIL_H_
#define WIN32UTIL_H_
#define INCLUDE_ALLOW_USERLEVEL
#include "includeCheck.h"
#include "vm_basic_types.h"
#include "vm_atomic.h"
#include "unicodeTypes.h"
#ifdef _WIN32
#include <windows.h>
/* Type definitions */
typedef enum AutorunState {
AUTORUN_UNDEFINED,
AUTORUN_ON,
AUTORUN_OFF
} AutorunState;
/* Defines */
#define VMX_SHUTDOWN_ORDER 0x100 // Application reserved last shutdown range.
#define UI_SHUTDOWN_ORDER 0x300 // Application reserved first shutdown range.
#define TOOLS_SHUTDOWN_ORDER 0x100 // Application reserved last shutdown range
/* Function declarations */
Unicode W32Util_GetInstallPath(void);
Unicode W32Util_GetInstallPath64(void);
/*
* The string returned is allocated on the heap and must be freed by the
* calling routine.
*/
Unicode W32Util_GetAppDataFilePath(ConstUnicode fileName);
Unicode W32Util_GetLocalAppDataFilePath(ConstUnicode fileName);
Unicode W32Util_GetCommonAppDataFilePath(ConstUnicode fileName);
Unicode W32Util_GetVmwareCommonAppDataFilePath(ConstUnicode fileName);
Unicode W32Util_GetMyDocumentPath(void);
Unicode W32Util_GetDefaultVMPath(ConstUnicode pref);
Unicode W32Util_GetInstalledFilePath(ConstUnicode fileName);
Unicode W32Util_GetInstalledFilePath64(ConstUnicode fileName);
HKEY W32Util_OpenProductRegKey(REGSAM access);
HKEY W32Util_OpenUserRegKey(REGSAM access);
LPTOP_LEVEL_EXCEPTION_FILTER W32Util_SetUnhandledExceptionFilter(void);
Bool W32Util_CreateProcessArgv(ConstUnicode lpApplicationName,
ConstUnicode *argv,
LPSECURITY_ATTRIBUTES lpProcessAttributes,
LPSECURITY_ATTRIBUTES lpThreadAttributes,
BOOL bInheritHandles,
DWORD dwCreationFlags,
LPVOID lpEnvironment,
ConstUnicode lpCurrentDirectory,
LPSTARTUPINFOA lpStartupInfo,
LPPROCESS_INFORMATION lpProcessInformation);
void W32Util_SplitCommandLine(char *commandLine,
int maxArgs,
char *progName,
int *argc,
char **argv);
BOOL W32Util_ReadFileTimeout(HANDLE hFile, // handle of file to read
LPVOID lpBuffer, // pointer to buffer that receives data
DWORD nNumberOfBytesToRead, // number of bytes to read
LPDWORD lpNumberOfBytesRead, // pointer to number of bytes read
DWORD msTimeout); // timeout in milliseconds
BOOL W32Util_WriteFileTimeout(HANDLE hFile, // handle to file to write to
LPCVOID lpBuffer, // pointer to data to write to file
DWORD nNumberOfBytesToWrite, // number of bytes to write
LPDWORD lpNumberOfBytesWritten, // pointer to number of bytes written
DWORD msTimeout); // timeout in milliseconds
Unicode W32Util_RealPath(ConstUnicode path);
BOOL W32Util_CheckForPrivilegeHeld(HANDLE token, LPCTSTR priv);
typedef BOOL (*SidFilterFunction)(PSID psid, void *cbData);
BOOL W32Util_GetEffectiveRightsForName(ConstUnicode user,
ConstUnicode path,
DWORD *rights);
BOOL W32Util_GetEffectiveRightsForSid(PSID psid,
ConstUnicode path,
DWORD *rights);
BOOL W32Util_ModifyRights(PSID psid,
ConstUnicode path,
DWORD rights,
BOOL isAllow);
void W32Util_FreeSids(PSID *sidList);
BOOL W32Util_GetMatchingSids(ConstUnicode path,
PSID **psidList,
SidFilterFunction matchCb,
void *cbData);
LPSTR W32Util_WideStrToAsciiStr(LPCWSTR wideStr);
LPWSTR W32Util_AsciiStrToWideStr(LPCSTR multiStr);
LPSTR W32Util_WideStrToMultiByteStr(LPCWSTR wideStr, UINT codePage);
LPWSTR W32Util_MultiByteStrToWideStr(LPCSTR multiStr, UINT codePage);
BOOL W32Util_WinSockAddReference(void);
BOOL W32Util_WinSockDereference(void);
Bool W32Util_RegisterService(Bool bRegister,
ConstUnicode name,
ConstUnicode displayName,
ConstUnicode description,
ConstUnicode binaryPath,
Unicode *errString);
Bool W32Util_DebugService(ConstUnicode dbgFile);
Bool W32Util_RegisterEventLog(ConstUnicode serviceName,
Bool registryVolatile,
DWORD typesSupported,
ConstUnicode eventMsgFile,
ConstUnicode categoryMsgFile,
DWORD categoryCount,
ConstUnicode paramMsgFile);
Bool W32Util_UnregisterEventLog(ConstUnicode serviceName);
typedef enum SetSDPrivsAccounts {
SDPRIV_GROUP_ADMIN = 0x1,
SDPRIV_GROUP_VMWARE = 0x2,
SDPRIV_USER_CURRENT = 0x4,
} SetSDPrivsAccounts;
Bool W32Util_SetSDPrivs(PSECURITY_DESCRIPTOR pSecurityDescriptor,
DWORD accessType, SetSDPrivsAccounts accounts,
PACL *pAcl, Unicode *errString);
BOOL W32Util_SetSecurityDescriptorW(PSECURITY_DESCRIPTOR pSecurityDescriptor,
ConstUnicode Owner, PACL *pAcl);
BOOL W32Util_SetSecurityDescriptorSid(PSECURITY_DESCRIPTOR sd, PSID sid,
PACL *pAcl);
BOOL W32Util_GetThreadHandle(HANDLE *handle);
Bool W32Util_AccessCheck(HANDLE token,
PSECURITY_DESCRIPTOR pSecurityDescriptor,
int desiredAccess);
Bool W32Util_HasAccessToFile(ConstUnicode filename, ACCESS_MASK desiredAccess,
HANDLE token);
Bool W32Util_GetSecurityDescriptor(ConstUnicode path,
PSECURITY_DESCRIPTOR *ppSecurityDescriptor);
void W32Util_InitStdioConsole(void);
void W32Util_ExitStdioConsole(void);
Bool W32Util_CreateWellKnownSid(WELL_KNOWN_SID_TYPE wsdType,
PSID domainSid,
PSID *pSid);
Bool W32Util_GetCurrentUserSid(PSID *pSid);
Bool W32Util_GetLocalAdminGroupSid(PSID *pSid);
Bool W32Util_GetVMwareGroupSid(PSID *pSid);
Bool W32Util_MakeSafeDirectory(ConstUnicode path);
Bool W32Util_IsDirectorySafe(ConstUnicode path);
Bool W32Util_DoesVolumeSupportAcls(ConstUnicode path);
Bool W32Util_GetRegistryAutorun(AutorunState* state);
Bool W32Util_SetRegistryAutorun(const AutorunState state);
Bool W32Util_AllowAdminCOM(void);
Unicode W32Util_GetAppDataPath(void);
Unicode W32Util_RobustGetLongPath(ConstUnicode path);
typedef enum SecureObjectType {
SecureObject_Process,
SecureObject_Thread
} SecureObjectType;
PSECURITY_DESCRIPTOR W32Util_ConstructSecureObjectSD(HANDLE hToken,
SecureObjectType type);
Bool W32Util_ReplaceObjectSD(HANDLE hObject,
const PSECURITY_DESCRIPTOR pSD);
HMODULE W32Util_GetModuleByAddress(const void *addr);
Bool W32Util_VerifyXPModeHostLicense(void);
Unicode W32Util_GetPipeNameFromFilePath(ConstUnicode fileName);
Bool W32Util_CheckGroupMembership(HANDLE hToken,
BOOL respectUAC,
Unicode *errString,
BOOL *bMember);
Bool W32Util_DismountVolumes(uint16 drive,
uint64 offset,
uint64 size,
void **handle);
Bool W32Util_CloseDismountHandle(void *handle);
Bool W32Util_EnableSafePathSearching(void);
CRITICAL_SECTION *W32Util_GetSingletonCriticalSection(Atomic_Ptr *csMemory);
#endif // _WIN32
#endif // WIN32UTIL_H_
|
