source: trunk/include/HandleManager.h@ 21301

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

Header updates.

File size: 16.5 KB
RevLine 
[262]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
[781]32#ifdef _OS2WIN_H
33#include <winos2def.h>
34#endif
35
[1857]36
[776]37//LPSECURITY_ATTRIBUTES
38
39
[262]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
[10010]86BOOL HMUpdtStdHandle(DWORD nStdHandle,
87 HANDLE hHandle);
[262]88
[10010]89
[262]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,
[3124]100 ULONG hHandle32);
[262]101
102DWORD HMHandleFree (ULONG hHandle16);
103
[2129]104DWORD HMHandleGetUserData (ULONG hHandle16);
[6937]105DWORD HMHandleSetUserData (ULONG hHandle16, ULONG dwUserData);
[2129]106
[262]107DWORD HMHandleValidate (ULONG hHandle16);
108
109DWORD HMHandleTranslateToWin (ULONG hHandle32,
[3124]110 PULONG phHandle16);
[262]111
112DWORD HMHandleTranslateToOS2 (ULONG hHandle16,
[3124]113 PULONG hHandle32);
[262]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
[278]127HANDLE HMCreateEvent (LPSECURITY_ATTRIBUTES lpsa,
128 BOOL bManualReset,
129 BOOL bInitialState,
130 LPCSTR lpName);
[262]131
[278]132HANDLE HMCreateMutex (LPSECURITY_ATTRIBUTES lpsa,
133 BOOL bInitialOwner,
134 LPCSTR lpName);
[262]135
[278]136HANDLE HMCreateFile (LPCSTR lpFileName,
137 DWORD dwDesiredAccess,
138 DWORD dwShareMode,
139 LPSECURITY_ATTRIBUTES lpSecurityAttributes,
140 DWORD dwCreationDisposition,
141 DWORD dwFlagsAndAttributes,
142 HANDLE hTemplateFile);
[262]143
[278]144HANDLE HMOpenFile (LPCSTR lpFileName,
145 OFSTRUCT* pOFStruct,
146 UINT fuMode);
[262]147
[278]148HANDLE HMOpenEvent (DWORD fdwAccess,
149 BOOL fInherit,
150 LPCSTR lpName);
[262]151
[278]152HANDLE HMOpenMutex (DWORD fdwAccess,
153 BOOL fInherit,
154 LPCSTR lpName);
[262]155
[9652]156BOOL HMSetHandleInformation (HANDLE hObject,
157 DWORD dwMask,
158 DWORD dwFlags);
159
160BOOL HMGetHandleInformation (HANDLE hObject,
161 LPDWORD lpdwFlags);
162
[278]163BOOL HMCloseHandle (HANDLE hObject);
[262]164
[278]165BOOL HMReadFile (HANDLE hFile,
166 LPVOID lpBuffer,
167 DWORD nNumberOfBytesToRead,
168 LPDWORD lpNumberOfBytesRead,
[3640]169 LPOVERLAPPED lpOverlapped,
170 LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
171
[278]172BOOL HMWriteFile (HANDLE hFile,
173 LPCVOID lpBuffer,
174 DWORD nNumberOfBytesToWrite,
175 LPDWORD lpNumberOfBytesWritten,
[7548]176 LPOVERLAPPED lpOverlapped,
177 LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
[262]178
[278]179DWORD HMGetFileType (HANDLE hFile);
[262]180
[278]181DWORD HMDeviceRequest (HANDLE hFile,
182 ULONG ulRequestCode,
183 ULONG arg1,
184 ULONG arg2,
185 ULONG arg3,
186 ULONG arg4);
[262]187
[278]188BOOL HMGetFileInformationByHandle (HANDLE hFile,
189 BY_HANDLE_FILE_INFORMATION *pHFI);
[262]190
[278]191BOOL HMSetEndOfFile (HANDLE hFile);
[262]192
[278]193BOOL HMSetFileTime (HANDLE hFile,
194 const FILETIME *pFT1,
195 const FILETIME *pFT2,
196 const FILETIME *pFT3);
[262]197
[3590]198BOOL HMGetFileTime (HANDLE hFile,
199 const FILETIME *pFT1,
200 const FILETIME *pFT2,
201 const FILETIME *pFT3);
202
[278]203DWORD HMGetFileSize (HANDLE hFile,
204 PDWORD pSize);
[262]205
[278]206DWORD HMSetFilePointer (HANDLE hFile,
207 LONG lDistanceToMove,
208 PLONG lpDistanceToMoveHigh,
209 DWORD dwMoveMethod);
[262]210
[278]211BOOL HMLockFile (HFILE hFile,
212 DWORD dwFileOffsetLow,
213 DWORD dwFileOffsetHigh,
214 DWORD nNumberOfBytesToLockLow,
215 DWORD nNumberOfBytesToLockHigh);
[262]216
[278]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
[4285]254DWORD HMMsgWaitForMultipleObjects (DWORD nCount,
255 HANDLE *pHandles,
256 BOOL fWaitAll,
257 DWORD dwMilliseconds,
258 DWORD dwWakeMask);
[2129]259
[4183]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
[7456]269BOOL HMCancelIo (HANDLE hDevice);
270
[278]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
[664]300HANDLE HMCreateFileMapping(
[9969]301 HANDLE hFile, /* [in] Handle of file to map */
[664]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 */
[776]306 LPCSTR name); /* [in] Name of file-mapping object */
[659]307
[664]308HANDLE HMOpenFileMapping(
309 DWORD access, /* [in] Access mode */
310 BOOL inherit, /* [in] Inherit flag */
311 LPCSTR name ); /* [in] Name of file-mapping object */
[659]312
313LPVOID HMMapViewOfFileEx (HANDLE hFileMappingObject,
314 DWORD dwDesiredAccess,
315 DWORD dwFileOffsetHigh,
316 DWORD dwFileOffsetLow,
317 DWORD dwNumberOfBytesToMap,
[4285]318 LPVOID lpBaseAddress);
[659]319
[689]320BOOL HMDuplicateHandle(HANDLE srcprocess,
321 HANDLE srchandle,
322 HANDLE destprocess,
323 PHANDLE desthandle,
324 DWORD fdwAccess,
325 BOOL fInherit,
[9912]326 DWORD fdwOptions);
[689]327
[2129]328DWORD HMOpenThreadToken(HANDLE ThreadHandle,
329 DWORD DesiredAccess,
[2326]330 DWORD OpenAsSelf,
[2129]331 HANDLE *TokenHandle);
332
333DWORD HMOpenProcessToken(HANDLE ProcessHandle,
334 DWORD DesiredAccess,
335 DWORD dwUserData,
336 HANDLE *TokenHandle);
337
[1856]338
[3124]339HANDLE HMCreateThread(LPSECURITY_ATTRIBUTES lpsa,
340 DWORD cbStack,
341 LPTHREAD_START_ROUTINE lpStartAddr,
342 LPVOID lpvThreadParm,
343 DWORD fdwCreate,
[3138]344 LPDWORD lpIDThread,
[21301]345 BOOL fRegisterThread = FALSE);
[3124]346BOOL HMSetThreadTerminated(HANDLE hThread);
347
[3819]348
[10074]349BOOL HMGetFileNameFromHandle(HANDLE hFile, LPSTR lpszFileName, DWORD cbFileName);
350
[262]351#ifdef __cplusplus__
352 }
353#endif
354
355#endif /* _HANDLEMANAGER_H_ */
Note: See TracBrowser for help on using the repository browser.