source: trunk/include/HandleManager.h@ 21811

Last change on this file since 21811 was 21301, checked in by ydario, 16 years ago

Header updates.
File size: 16.5 KB
Line 
1/*
2 * Project Odin Software License can be found in LICENSE.TXT
3 * Win32 Unified Handle Manager for OS/2
4 * 1998/02/11 PH Patrick Haller (haller@zebra.fh-weingarten.de)
5 *
6 * @(#) HandleManager.Cpp 1.0.0 1998/02/11 PH start
7 */
8
9#ifndef _HANDLEMANAGER_H_
10#define _HANDLEMANAGER_H_
11
12
13/*****************************************************************************
14 * Remark *
15 *****************************************************************************
16
17 1998/02/11 PH The interface to the handle manager is twofold:
18 a) HMxxx routines to be called from the "top" from the
19 KERNEL32 stubs
20 b) the HMDeviceHandler class is actually a workaround for
21 the device driver that would handle the requests on Win32.
22 To implement a new pseudo-device, one has create a new
23 HMDeviceHandler class and link it into the table in the
24 HANDLEMANAGER.CPP file.
25 */
26
27
28/*****************************************************************************
29 * Includes *
30 *****************************************************************************/
31
32#ifdef _OS2WIN_H
33#include <winos2def.h>
34#endif
35
36
37//LPSECURITY_ATTRIBUTES
38
39
40/*****************************************************************************
41 * Defines & Macros *
42 *****************************************************************************/
43
44 /* 1998/02/12 PH Correction of os2win.h */
45#undef FILE_TYPE_UNKNOWN
46#define FILE_TYPE_UNKNOWN 0x0000
47
48#undef FILE_TYPE_DISK
49#define FILE_TYPE_DISK 0x0001
50
51#undef FILE_TYPE_CHAR
52#define FILE_TYPE_CHAR 0x0002
53
54#undef FILE_TYPE_PIPE
55#define FILE_TYPE_PIPE 0x0003
56
57#undef FILE_TYPE_REMOTE
58#define FILE_TYPE_REMOTE 0x8000
59
60#ifndef INVALID_HANDLE_ERROR
61#define INVALID_HANDLE_ERROR (-1)
62#endif
63
64
65/*****************************************************************************
66 * Structures *
67 *****************************************************************************/
68
69
70/*****************************************************************************
71 * Prototypes *
72 *****************************************************************************/
73
74DWORD HMInitialize(void); /* initialize the HandleManager */
75
76DWORD HMTerminate(void); /* terminate the HandleManager */
77
78
79 /* handle manager version of GetStdHandle, Open32 can't really help us here */
80HANDLE HMGetStdHandle(DWORD nStdHandle);
81
82 /* handle manager version of GetStdHandle, Open32 can't really help us here */
83BOOL HMSetStdHandle(DWORD nStdHandle,
84 HANDLE hHandle);
85
86BOOL HMUpdtStdHandle(DWORD nStdHandle,
87 HANDLE hHandle);
88
89
90/*****************************************************************************/
91/* handle translation buffer management */
92/* */
93/* Since some Win32 applications rely (!) on 16-bit handles, we've got to do */
94/* 32-bit to 16-bit and vs vsa translation here. */
95/* Filehandle-based functions should be routed via the handlemanager instead */
96/* of going to Open32 directly. */
97/*****************************************************************************/
98
99DWORD HMHandleAllocate (PULONG phHandle16,
100 ULONG hHandle32);
101
102DWORD HMHandleFree (ULONG hHandle16);
103
104DWORD HMHandleGetUserData (ULONG hHandle16);
105DWORD HMHandleSetUserData (ULONG hHandle16, ULONG dwUserData);
106
107DWORD HMHandleValidate (ULONG hHandle16);
108
109DWORD HMHandleTranslateToWin (ULONG hHandle32,
110 PULONG phHandle16);
111
112DWORD HMHandleTranslateToOS2 (ULONG hHandle16,
113 PULONG hHandle32);
114
115DWORD HMHandleTranslateToOS2i(ULONG hHandle16);
116
117
118/*****************************************************************************
119 * Forwarders *
120 *****************************************************************************/
121
122// enable C linkage to avoid parameter mangling
123#ifdef __cplusplus__
124extern "C" {
125#endif
126
127HANDLE HMCreateEvent (LPSECURITY_ATTRIBUTES lpsa,
128 BOOL bManualReset,
129 BOOL bInitialState,
130 LPCSTR lpName);
131
132HANDLE HMCreateMutex (LPSECURITY_ATTRIBUTES lpsa,
133 BOOL bInitialOwner,
134 LPCSTR lpName);
135
136HANDLE HMCreateFile (LPCSTR lpFileName,
137 DWORD dwDesiredAccess,
138 DWORD dwShareMode,
139 LPSECURITY_ATTRIBUTES lpSecurityAttributes,
140 DWORD dwCreationDisposition,
141 DWORD dwFlagsAndAttributes,
142 HANDLE hTemplateFile);
143
144HANDLE HMOpenFile (LPCSTR lpFileName,
145 OFSTRUCT* pOFStruct,
146 UINT fuMode);
147
148HANDLE HMOpenEvent (DWORD fdwAccess,
149 BOOL fInherit,
150 LPCSTR lpName);
151
152HANDLE HMOpenMutex (DWORD fdwAccess,
153 BOOL fInherit,
154 LPCSTR lpName);
155
156BOOL HMSetHandleInformation (HANDLE hObject,
157 DWORD dwMask,
158 DWORD dwFlags);
159
160BOOL HMGetHandleInformation (HANDLE hObject,
161 LPDWORD lpdwFlags);
162
163BOOL HMCloseHandle (HANDLE hObject);
164
165BOOL HMReadFile (HANDLE hFile,
166 LPVOID lpBuffer,
167 DWORD nNumberOfBytesToRead,
168 LPDWORD lpNumberOfBytesRead,
169 LPOVERLAPPED lpOverlapped,
170 LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
171
172BOOL HMWriteFile (HANDLE hFile,
173 LPCVOID lpBuffer,
174 DWORD nNumberOfBytesToWrite,
175 LPDWORD lpNumberOfBytesWritten,
176 LPOVERLAPPED lpOverlapped,
177 LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
178
179DWORD HMGetFileType (HANDLE hFile);
180
181DWORD HMDeviceRequest (HANDLE hFile,
182 ULONG ulRequestCode,
183 ULONG arg1,
184 ULONG arg2,
185 ULONG arg3,
186 ULONG arg4);
187
188BOOL HMGetFileInformationByHandle (HANDLE hFile,
189 BY_HANDLE_FILE_INFORMATION *pHFI);
190
191BOOL HMSetEndOfFile (HANDLE hFile);
192
193BOOL HMSetFileTime (HANDLE hFile,
194 const FILETIME *pFT1,
195 const FILETIME *pFT2,
196 const FILETIME *pFT3);
197
198BOOL HMGetFileTime (HANDLE hFile,
199 const FILETIME *pFT1,
200 const FILETIME *pFT2,
201 const FILETIME *pFT3);
202
203DWORD HMGetFileSize (HANDLE hFile,
204 PDWORD pSize);
205
206DWORD HMSetFilePointer (HANDLE hFile,
207 LONG lDistanceToMove,
208 PLONG lpDistanceToMoveHigh,
209 DWORD dwMoveMethod);
210
211BOOL HMLockFile (HFILE hFile,
212 DWORD dwFileOffsetLow,
213 DWORD dwFileOffsetHigh,
214 DWORD nNumberOfBytesToLockLow,
215 DWORD nNumberOfBytesToLockHigh);
216
217BOOL HMLockFileEx (HANDLE hFile,
218 DWORD dwFlags,
219 DWORD dwReserved,
220 DWORD nNumberOfBytesToLockLow,
221 DWORD nNumberOfBytesToLockHigh,
222 LPOVERLAPPED lpOverlapped);
223
224BOOL HMUnlockFile (HANDLE hFile,
225 DWORD dwFileOffsetLow,
226 DWORD dwFileOffsetHigh,
227 DWORD cbUnlockLow,
228 DWORD cbUnlockHigh);
229
230BOOL HMUnlockFileEx (HANDLE hFile,
231 DWORD dwReserved,
232 DWORD nNumberOfBytesToLockLow,
233 DWORD nNumberOfBytesToLockHigh,
234 LPOVERLAPPED lpOverlapped);
235
236DWORD HMWaitForSingleObject (HANDLE hObject,
237 DWORD dwTimeout);
238
239DWORD HMWaitForSingleObjectEx (HANDLE hObject,
240 DWORD dwTimeout,
241 BOOL fAlertable);
242
243DWORD HMWaitForMultipleObjects (DWORD cObjects,
244 HANDLE *lphObjects,
245 BOOL fWaitAll,
246 DWORD dwTimeout);
247
248DWORD HMWaitForMultipleObjectsEx (DWORD cObjects,
249 HANDLE *lphObjects,
250 BOOL fWaitAll,
251 DWORD dwTimeout,
252 BOOL fAlertable);
253
254DWORD HMMsgWaitForMultipleObjects (DWORD nCount,
255 HANDLE *pHandles,
256 BOOL fWaitAll,
257 DWORD dwMilliseconds,
258 DWORD dwWakeMask);
259
260BOOL HMDeviceIoControl (HANDLE hDevice,
261 DWORD dwIoControlCode,
262 LPVOID lpInBuffer,
263 DWORD nInBufferSize,
264 LPVOID lpOutBuffer,
265 DWORD nOutBufferSize,
266 LPDWORD lpBytesReturned,
267 LPOVERLAPPED lpOverlapped);
268
269BOOL HMCancelIo (HANDLE hDevice);
270
271BOOL HMFlushFileBuffers (HANDLE hObject);
272
273BOOL HMGetOverlappedResult (HANDLE hObject,
274 LPOVERLAPPED lpOverlapped,
275 LPDWORD lpNumberOfBytesTransferred,
276 BOOL bWait);
277
278BOOL HMReleaseMutex (HANDLE hObject);
279
280BOOL HMSetEvent (HANDLE hEvent);
281
282BOOL HMPulseEvent (HANDLE hEvent);
283
284BOOL HMResetEvent (HANDLE hEvent);
285
286HANDLE HMCreateSemaphore (LPSECURITY_ATTRIBUTES lpsa,
287 LONG lInitialCount,
288 LONG lMaximumCount,
289 LPCSTR lpszSemaphoreName);
290
291HANDLE HMOpenSemaphore (DWORD fdwAccess,
292 BOOL fInheritHandle,
293 LPCSTR lpszSemaphoreName);
294
295BOOL HMReleaseSemaphore (HANDLE hSemaphore,
296 LONG cReleaseCount,
297 LPLONG lpPreviousCount);
298
299
300HANDLE HMCreateFileMapping(
301 HANDLE hFile, /* [in] Handle of file to map */
302 SECURITY_ATTRIBUTES *sa, /* [in] Optional security attributes*/
303 DWORD protect, /* [in] Protection for mapping object */
304 DWORD size_high, /* [in] High-order 32 bits of object size */
305 DWORD size_low, /* [in] Low-order 32 bits of object size */
306 LPCSTR name); /* [in] Name of file-mapping object */
307
308HANDLE HMOpenFileMapping(
309 DWORD access, /* [in] Access mode */
310 BOOL inherit, /* [in] Inherit flag */
311 LPCSTR name ); /* [in] Name of file-mapping object */
312
313LPVOID HMMapViewOfFileEx (HANDLE hFileMappingObject,
314 DWORD dwDesiredAccess,
315 DWORD dwFileOffsetHigh,
316 DWORD dwFileOffsetLow,
317 DWORD dwNumberOfBytesToMap,
318 LPVOID lpBaseAddress);
319
320BOOL HMDuplicateHandle(HANDLE srcprocess,
321 HANDLE srchandle,
322 HANDLE destprocess,
323 PHANDLE desthandle,
324 DWORD fdwAccess,
325 BOOL fInherit,
326 DWORD fdwOptions);
327
328DWORD HMOpenThreadToken(HANDLE ThreadHandle,
329 DWORD DesiredAccess,
330 DWORD OpenAsSelf,
331 HANDLE *TokenHandle);
332
333DWORD HMOpenProcessToken(HANDLE ProcessHandle,
334 DWORD DesiredAccess,
335 DWORD dwUserData,
336 HANDLE *TokenHandle);
337
338
339HANDLE HMCreateThread(LPSECURITY_ATTRIBUTES lpsa,
340 DWORD cbStack,
341 LPTHREAD_START_ROUTINE lpStartAddr,
342 LPVOID lpvThreadParm,
343 DWORD fdwCreate,
344 LPDWORD lpIDThread,
345 BOOL fRegisterThread = FALSE);
346BOOL HMSetThreadTerminated(HANDLE hThread);
347
348
349BOOL HMGetFileNameFromHandle(HANDLE hFile, LPSTR lpszFileName, DWORD cbFileName);
350
351#ifdef __cplusplus__
352 }
353#endif
354
355#endif /* _HANDLEMANAGER_H_ */
Note: See TracBrowser for help on using the repository browser.