handle.c File Reference

#include <k32.h>
#include <debug.h>

Include dependency graph for handle.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
HANDLE	TranslateStdHandle (IN HANDLE hHandle)
BOOL WINAPI	GetHandleInformation (IN HANDLE hObject, OUT LPDWORD lpdwFlags)
BOOL WINAPI	SetHandleInformation (IN HANDLE hObject, IN DWORD dwMask, IN DWORD dwFlags)
BOOL WINAPI	CloseHandle (IN HANDLE hObject)
BOOL WINAPI	DuplicateHandle (IN HANDLE hSourceProcessHandle, IN HANDLE hSourceHandle, IN HANDLE hTargetProcessHandle, OUT LPHANDLE lpTargetHandle, IN DWORD dwDesiredAccess, IN BOOL bInheritHandle, IN DWORD dwOptions)
UINT WINAPI	SetHandleCount (IN UINT nCount)
DWORD WINAPI	GetHandleContext (IN HANDLE Handle)
HANDLE WINAPI	CreateSocketHandle (VOID)
BOOL WINAPI	SetHandleContext (IN HANDLE Handle, IN DWORD Context)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 13 of file handle.c.

Function Documentation

CloseHandle()

BOOL WINAPI CloseHandle

(

IN HANDLE

hObject

)

Definition at line 129 of file handle.c.

{
    NTSTATUS Status;
 
    hObject = TranslateStdHandle(hObject);
 
    if (IsConsoleHandle(hObject)) return CloseConsoleHandle(hObject);
 
    Status = NtClose(hObject);
    if (NT_SUCCESS(Status)) return TRUE;
 
    BaseSetLastNTError(Status);
    return FALSE;
}

CreateSocketHandle()

HANDLE WINAPI CreateSocketHandle

(

VOID

)

Definition at line 231 of file handle.c.

{
    /* This is Windows behavior, not a ReactOS Stub */
    DbgPrintEx(0, 0, "Unsupported API - kernel32!CreateSocketHandle() called\n");
    SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
    return FALSE;
}

DuplicateHandle()

BOOL WINAPI DuplicateHandle	(	IN HANDLE	hSourceProcessHandle,
		IN HANDLE	hSourceHandle,
		IN HANDLE	hTargetProcessHandle,
		OUT LPHANDLE	lpTargetHandle,
		IN DWORD	dwDesiredAccess,
		IN BOOL	bInheritHandle,
		IN DWORD	dwOptions
	)

Definition at line 149 of file handle.c.

{
    NTSTATUS Status;
    HANDLE hTargetHandle;
 
    hSourceHandle = TranslateStdHandle(hSourceHandle);
 
    if ((IsConsoleHandle(hSourceHandle)) &&
        ((hSourceHandle != NtCurrentProcess()) &&
         (hSourceHandle != NtCurrentThread())))
    {
        /*
         * We can duplicate console handles only if both the source
         * and the target processes are in fact the current process.
         */
        if ((hSourceProcessHandle != NtCurrentProcess()) ||
            (hTargetProcessHandle != NtCurrentProcess()))
        {
            BaseSetLastNTError(STATUS_INVALID_PARAMETER);
            return FALSE;
        }
 
        hTargetHandle = DuplicateConsoleHandle(hSourceHandle,
                                               dwDesiredAccess,
                                               bInheritHandle,
                                               dwOptions);
        if (hTargetHandle != INVALID_HANDLE_VALUE)
        {
            if (lpTargetHandle) *lpTargetHandle = hTargetHandle;
            return TRUE;
        }
 
        return FALSE;
    }
 
    Status = NtDuplicateObject(hSourceProcessHandle,
                               hSourceHandle,
                               hTargetProcessHandle,
                               lpTargetHandle,
                               dwDesiredAccess,
                               bInheritHandle ? OBJ_INHERIT : 0,
                               dwOptions);
    if (NT_SUCCESS(Status)) return TRUE;
 
    BaseSetLastNTError(Status);
    return FALSE;
}

Referenced by _dup2(), ACTION_FinishCustomActions(), appbar_message(), chm_dup(), cmd_ctty(), ATL::CAtlFileMappingBase::CopyFrom(), CorDebugProcess_Create(), CreateLobbyMessageReceptionThread(), CRYPT_FileOpenStore(), CRYPT_RegOpenStore(), custom_client_thread(), dll_entry_point(), DoDuplicateHandle(), DP_CreatePlayer(), DPL_CreateAndSetLobbyHandles(), elf_map_file(), EnumOLEVERB_Clone(), get_droptarget_local_handle(), IDirectPlay4Impl_EnumSessions(), main(), MyDuplicateHandle(), ObjectFromLresult(), PerformRedirection(), read_pipe_test(), SeclCreateProcessWithLogonW(), SHMapHandle(), StartupWindowThread(), test_Console(), test_CreateRemoteThread(), Test_DuplicateHandle(), test_DuplicateHandle(), test_event_security(), test_ExitProcess(), test_file_access(), test_file_disposition_information(), test_file_security(), test_filemap_security(), test_flags_NtQueryDirectoryFile(), test_GetMappedFileName(), test_Handles(), test_handles(), test_mapping(), test_MapViewOfFile(), test_mutex_security(), test_named_pipe_security(), test_process_access(), test_process_security_child(), test_semaphore_security(), test_TerminateProcess(), test_thread_security(), WahOpenCurrentThread(), WSPDuplicateSocket(), WTSQueryUserToken(), and xmlGetGlobalState().

GetHandleContext()

DWORD WINAPI GetHandleContext

(

IN HANDLE

Handle

)

Definition at line 218 of file handle.c.

{
    /* This is Windows behavior, not a ReactOS Stub */
    DbgPrintEx(0, 0, "Unsupported API - kernel32!GetHandleContext() called\n");
    SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
    return FALSE;
}

GetHandleInformation()

BOOL WINAPI GetHandleInformation	(	IN HANDLE	hObject,
		OUT LPDWORD	lpdwFlags
	)

Definition at line 40 of file handle.c.

{
    OBJECT_HANDLE_ATTRIBUTE_INFORMATION HandleInfo;
    ULONG BytesWritten;
    NTSTATUS Status;
    DWORD Flags;
 
    hObject = TranslateStdHandle(hObject);
 
    if (IsConsoleHandle(hObject))
    {
        return GetConsoleHandleInformation(hObject, lpdwFlags);
    }
 
    Status = NtQueryObject(hObject,
                           ObjectHandleFlagInformation,
                           &HandleInfo,
                           sizeof(OBJECT_HANDLE_ATTRIBUTE_INFORMATION),
                           &BytesWritten);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    Flags = 0;
    if (HandleInfo.Inherit) Flags |= HANDLE_FLAG_INHERIT;
    if (HandleInfo.ProtectFromClose) Flags |= HANDLE_FLAG_PROTECT_FROM_CLOSE;
    *lpdwFlags = Flags;
    return TRUE;
}

Referenced by do_spawnT(), test_close(), test_DuplicateHandle(), test_handles(), and WsSockFindIfsSocket().

SetHandleContext()

BOOL WINAPI SetHandleContext	(	IN HANDLE	Handle,
		IN DWORD	Context
	)

Definition at line 244 of file handle.c.

{
    /* This is Windows behavior, not a ReactOS Stub */
    DbgPrintEx(0, 0, "Unsupported API - kernel32!SetHandleContext() called\n");
    SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
    return FALSE;
}

SetHandleCount()

UINT WINAPI SetHandleCount

(

IN UINT

nCount

)

Definition at line 208 of file handle.c.

{
    return nCount;
}

SetHandleInformation()

BOOL WINAPI SetHandleInformation	(	IN HANDLE	hObject,
		IN DWORD	dwMask,
		IN DWORD	dwFlags
	)

Definition at line 78 of file handle.c.

{
    OBJECT_HANDLE_ATTRIBUTE_INFORMATION HandleInfo;
    ULONG BytesWritten;
    NTSTATUS Status;
 
    hObject = TranslateStdHandle(hObject);
 
    if (IsConsoleHandle(hObject))
    {
        return SetConsoleHandleInformation(hObject, dwMask, dwFlags);
    }
 
    Status = NtQueryObject(hObject,
                           ObjectHandleFlagInformation,
                           &HandleInfo,
                           sizeof(OBJECT_HANDLE_ATTRIBUTE_INFORMATION),
                           &BytesWritten);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    if (dwMask & HANDLE_FLAG_INHERIT)
    {
        HandleInfo.Inherit = (dwFlags & HANDLE_FLAG_INHERIT) != 0;
    }
 
    if (dwMask & HANDLE_FLAG_PROTECT_FROM_CLOSE)
    {
        HandleInfo.ProtectFromClose = (dwFlags & HANDLE_FLAG_PROTECT_FROM_CLOSE) != 0;
    }
 
    Status = NtSetInformationObject(hObject,
                                    ObjectHandleFlagInformation,
                                    &HandleInfo,
                                    sizeof(HandleInfo));
    if (NT_SUCCESS(Status)) return TRUE;
 
    BaseSetLastNTError(Status);
    return FALSE;
}

Referenced by CreateClientProcess(), ExecutePipeline(), fork_helper(), main(), read_reg_output_(), and test_DuplicateHandle().

TranslateStdHandle()

HANDLE TranslateStdHandle

(

IN HANDLE

hHandle

)

Definition at line 19 of file handle.c.

{
    PRTL_USER_PROCESS_PARAMETERS Ppb = NtCurrentPeb()->ProcessParameters;
 
    switch ((ULONG_PTR)hHandle)
    {
        case STD_INPUT_HANDLE:  return Ppb->StandardInput;
        case STD_OUTPUT_HANDLE: return Ppb->StandardOutput;
        case STD_ERROR_HANDLE:  return Ppb->StandardError;
    }
 
    return hHandle;
}

Referenced by CloseHandle(), DuplicateHandle(), FlushFileBuffers(), GetFileType(), GetHandleInformation(), ReadFile(), RegisterWaitForSingleObject(), RegisterWaitForSingleObjectEx(), SetHandleInformation(), SignalObjectAndWait(), WaitForMultipleObjectsEx(), WaitForSingleObjectEx(), and WriteFile().