|
Packit Service |
fa4841 |
/**
|
|
Packit Service |
fa4841 |
* WinPR: Windows Portable Runtime
|
|
Packit Service |
fa4841 |
* Handle Management
|
|
Packit Service |
fa4841 |
*
|
|
Packit Service |
fa4841 |
* Copyright 2012 Marc-Andre Moreau <marcandre.moreau@gmail.com>
|
|
Packit Service |
fa4841 |
*
|
|
Packit Service |
fa4841 |
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
Packit Service |
fa4841 |
* you may not use this file except in compliance with the License.
|
|
Packit Service |
fa4841 |
* You may obtain a copy of the License at
|
|
Packit Service |
fa4841 |
*
|
|
Packit Service |
fa4841 |
* http://www.apache.org/licenses/LICENSE-2.0
|
|
Packit Service |
fa4841 |
*
|
|
Packit Service |
fa4841 |
* Unless required by applicable law or agreed to in writing, software
|
|
Packit Service |
fa4841 |
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
Packit Service |
fa4841 |
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
Packit Service |
fa4841 |
* See the License for the specific language governing permissions and
|
|
Packit Service |
fa4841 |
* limitations under the License.
|
|
Packit Service |
fa4841 |
*/
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
#ifndef WINPR_HANDLE_PRIVATE_H
|
|
Packit Service |
fa4841 |
#define WINPR_HANDLE_PRIVATE_H
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
#include <winpr/handle.h>
|
|
Packit Service |
fa4841 |
#include <winpr/file.h>
|
|
Packit Service |
fa4841 |
#include <winpr/synch.h>
|
|
Packit Service |
fa4841 |
#include <winpr/winsock.h>
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_NONE 0
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_PROCESS 1
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_THREAD 2
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_EVENT 3
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_MUTEX 4
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_SEMAPHORE 5
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_TIMER 6
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_NAMED_PIPE 7
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_ANONYMOUS_PIPE 8
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_ACCESS_TOKEN 9
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_FILE 10
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_TIMER_QUEUE 11
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_TIMER_QUEUE_TIMER 12
|
|
Packit Service |
fa4841 |
#define HANDLE_TYPE_COMM 13
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
#define WINPR_HANDLE_DEF() \
|
|
Packit Service |
fa4841 |
ULONG Type; \
|
|
Packit Service |
fa4841 |
ULONG Mode; \
|
|
Packit Service |
fa4841 |
HANDLE_OPS* ops
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcIsHandled)(HANDLE handle);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcCloseHandle)(HANDLE handle);
|
|
Packit Service |
fa4841 |
typedef int (*pcGetFd)(HANDLE handle);
|
|
Packit Service |
fa4841 |
typedef DWORD (*pcCleanupHandle)(HANDLE handle);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcReadFile)(PVOID Object, LPVOID lpBuffer, DWORD nNumberOfBytesToRead,
|
|
Packit Service |
fa4841 |
LPDWORD lpNumberOfBytesRead, LPOVERLAPPED lpOverlapped);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcReadFileEx)(HANDLE hFile, LPVOID lpBuffer, DWORD nNumberOfBytesToRead,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED lpOverlapped,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcReadFileScatter)(HANDLE hFile, FILE_SEGMENT_ELEMENT aSegmentArray[],
|
|
Packit Service |
fa4841 |
DWORD nNumberOfBytesToRead, LPDWORD lpReserved,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED lpOverlapped);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcWriteFile)(PVOID Object, LPCVOID lpBuffer, DWORD nNumberOfBytesToWrite,
|
|
Packit Service |
fa4841 |
LPDWORD lpNumberOfBytesWritten, LPOVERLAPPED lpOverlapped);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcWriteFileEx)(HANDLE hFile, LPCVOID lpBuffer, DWORD nNumberOfBytesToWrite,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED lpOverlapped,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcWriteFileGather)(HANDLE hFile, FILE_SEGMENT_ELEMENT aSegmentArray[],
|
|
Packit Service |
fa4841 |
DWORD nNumberOfBytesToWrite, LPDWORD lpReserved,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED lpOverlapped);
|
|
Packit Service |
fa4841 |
typedef DWORD (*pcGetFileSize)(HANDLE handle, LPDWORD lpFileSizeHigh);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcFlushFileBuffers)(HANDLE hFile);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcSetEndOfFile)(HANDLE handle);
|
|
Packit Service |
fa4841 |
typedef DWORD (*pcSetFilePointer)(HANDLE handle, LONG lDistanceToMove, PLONG lpDistanceToMoveHigh,
|
|
Packit Service |
fa4841 |
DWORD dwMoveMethod);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcSetFilePointerEx)(HANDLE hFile, LARGE_INTEGER liDistanceToMove,
|
|
Packit Service |
fa4841 |
PLARGE_INTEGER lpNewFilePointer, DWORD dwMoveMethod);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcLockFile)(HANDLE hFile, DWORD dwFileOffsetLow, DWORD dwFileOffsetHigh,
|
|
Packit Service |
fa4841 |
DWORD nNumberOfBytesToLockLow, DWORD nNumberOfBytesToLockHigh);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcLockFileEx)(HANDLE hFile, DWORD dwFlags, DWORD dwReserved,
|
|
Packit Service |
fa4841 |
DWORD nNumberOfBytesToLockLow, DWORD nNumberOfBytesToLockHigh,
|
|
Packit Service |
fa4841 |
LPOVERLAPPED lpOverlapped);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcUnlockFile)(HANDLE hFile, DWORD dwFileOffsetLow, DWORD dwFileOffsetHigh,
|
|
Packit Service |
fa4841 |
DWORD nNumberOfBytesToUnlockLow, DWORD nNumberOfBytesToUnlockHigh);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcUnlockFileEx)(HANDLE hFile, DWORD dwReserved, DWORD nNumberOfBytesToUnlockLow,
|
|
Packit Service |
fa4841 |
DWORD nNumberOfBytesToUnlockHigh, LPOVERLAPPED lpOverlapped);
|
|
Packit Service |
fa4841 |
typedef BOOL (*pcSetFileTime)(HANDLE hFile, const FILETIME* lpCreationTime,
|
|
Packit Service |
fa4841 |
const FILETIME* lpLastAccessTime, const FILETIME* lpLastWriteTime);
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
typedef struct _HANDLE_OPS
|
|
Packit Service |
fa4841 |
{
|
|
Packit Service |
fa4841 |
pcIsHandled IsHandled;
|
|
Packit Service |
fa4841 |
pcCloseHandle CloseHandle;
|
|
Packit Service |
fa4841 |
pcGetFd GetFd;
|
|
Packit Service |
fa4841 |
pcCleanupHandle CleanupHandle;
|
|
Packit Service |
fa4841 |
pcReadFile ReadFile;
|
|
Packit Service |
fa4841 |
pcReadFileEx ReadFileEx;
|
|
Packit Service |
fa4841 |
pcReadFileScatter ReadFileScatter;
|
|
Packit Service |
fa4841 |
pcWriteFile WriteFile;
|
|
Packit Service |
fa4841 |
pcWriteFileEx WriteFileEx;
|
|
Packit Service |
fa4841 |
pcWriteFileGather WriteFileGather;
|
|
Packit Service |
fa4841 |
pcGetFileSize GetFileSize;
|
|
Packit Service |
fa4841 |
pcFlushFileBuffers FlushFileBuffers;
|
|
Packit Service |
fa4841 |
pcSetEndOfFile SetEndOfFile;
|
|
Packit Service |
fa4841 |
pcSetFilePointer SetFilePointer;
|
|
Packit Service |
fa4841 |
pcSetFilePointerEx SetFilePointerEx;
|
|
Packit Service |
fa4841 |
pcLockFile LockFile;
|
|
Packit Service |
fa4841 |
pcLockFileEx LockFileEx;
|
|
Packit Service |
fa4841 |
pcUnlockFile UnlockFile;
|
|
Packit Service |
fa4841 |
pcUnlockFileEx UnlockFileEx;
|
|
Packit Service |
fa4841 |
pcSetFileTime SetFileTime;
|
|
Packit Service |
fa4841 |
} HANDLE_OPS;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
struct winpr_handle
|
|
Packit Service |
fa4841 |
{
|
|
Packit Service |
fa4841 |
WINPR_HANDLE_DEF();
|
|
Packit Service |
fa4841 |
};
|
|
Packit Service |
fa4841 |
typedef struct winpr_handle WINPR_HANDLE;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
static INLINE void WINPR_HANDLE_SET_TYPE_AND_MODE(void* _handle, ULONG _type, ULONG _mode)
|
|
Packit Service |
fa4841 |
{
|
|
Packit Service |
fa4841 |
WINPR_HANDLE* hdl = (WINPR_HANDLE*)_handle;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
hdl->Type = _type;
|
|
Packit Service |
fa4841 |
hdl->Mode = _mode;
|
|
Packit Service |
fa4841 |
}
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
static INLINE BOOL winpr_Handle_GetInfo(HANDLE handle, ULONG* pType, WINPR_HANDLE** pObject)
|
|
Packit Service |
fa4841 |
{
|
|
Packit Service |
fa4841 |
WINPR_HANDLE* wHandle;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
if (handle == NULL)
|
|
Packit Service |
fa4841 |
return FALSE;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
/* INVALID_HANDLE_VALUE is an invalid value for every handle, but it
|
|
Packit Service |
fa4841 |
* confuses the clang scanbuild analyzer. */
|
|
Packit Service |
fa4841 |
#ifndef __clang_analyzer__
|
|
Packit Service |
fa4841 |
if (handle == INVALID_HANDLE_VALUE)
|
|
Packit Service |
fa4841 |
return FALSE;
|
|
Packit Service |
fa4841 |
#endif
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
wHandle = (WINPR_HANDLE*)handle;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
*pType = wHandle->Type;
|
|
Packit Service |
fa4841 |
*pObject = handle;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
return TRUE;
|
|
Packit Service |
fa4841 |
}
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
static INLINE int winpr_Handle_getFd(HANDLE handle)
|
|
Packit Service |
fa4841 |
{
|
|
Packit Service |
fa4841 |
WINPR_HANDLE* hdl;
|
|
Packit Service |
fa4841 |
ULONG type;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
if (!winpr_Handle_GetInfo(handle, &type, &hdl))
|
|
Packit Service |
fa4841 |
return -1;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
if (!hdl || !hdl->ops || !hdl->ops->GetFd)
|
|
Packit Service |
fa4841 |
return -1;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
return hdl->ops->GetFd(handle);
|
|
Packit Service |
fa4841 |
}
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
static INLINE DWORD winpr_Handle_cleanup(HANDLE handle)
|
|
Packit Service |
fa4841 |
{
|
|
Packit Service |
fa4841 |
WINPR_HANDLE* hdl;
|
|
Packit Service |
fa4841 |
ULONG type;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
if (!winpr_Handle_GetInfo(handle, &type, &hdl))
|
|
Packit Service |
fa4841 |
return WAIT_FAILED;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
if (!hdl || !hdl->ops)
|
|
Packit Service |
fa4841 |
return WAIT_FAILED;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
/* If there is no cleanup function, assume all ok. */
|
|
Packit Service |
fa4841 |
if (!hdl->ops->CleanupHandle)
|
|
Packit Service |
fa4841 |
return WAIT_OBJECT_0;
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
return hdl->ops->CleanupHandle(handle);
|
|
Packit Service |
fa4841 |
}
|
|
Packit Service |
fa4841 |
|
|
Packit Service |
fa4841 |
#endif /* WINPR_HANDLE_PRIVATE_H */
|