Blame winpr/libwinpr/handle/handle.h

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 */