winsta.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_WINSTATION_OBJECT

Macros
#define	WINSTA_OBJ_DIR   L"\\Windows\\WindowStations"
#define	SESSION_DIR   L"\\Sessions"
#define	WSS_LOCKED   (1)
#define	WSS_NOINTERACTIVE   (2)
#define	WSS_NOIO   (4)
#define	WSS_SHUTDOWN   (8)
#define	WSS_DYING   (16)
#define	WSS_REALSHUTDOWN   (32)

Typedefs
typedef struct _WINSTATION_OBJECT	WINSTATION_OBJECT
typedef struct _WINSTATION_OBJECT *	PWINSTATION_OBJECT

Functions
	C_ASSERT (offsetof(WINSTATION_OBJECT, Flags)==0x10)
	C_ASSERT (offsetof(WINSTATION_OBJECT, spklList)==0x14)
	C_ASSERT (offsetof(WINSTATION_OBJECT, ptiClipLock)==0x18)
	C_ASSERT (offsetof(WINSTATION_OBJECT, ptiDrawingClipboard)==0x1c)
	C_ASSERT (offsetof(WINSTATION_OBJECT, spwndClipOpen)==0x20)
	C_ASSERT (offsetof(WINSTATION_OBJECT, spwndClipViewer)==0x24)
	C_ASSERT (offsetof(WINSTATION_OBJECT, spwndClipOwner)==0x28)
NTSTATUS NTAPI	InitWindowStationImpl (VOID)
NTSTATUS NTAPI	UserCreateWinstaDirectory (VOID)
NTSTATUS NTAPI	IntWinStaObjectDelete (_In_ PVOID Parameters)
NTSTATUS NTAPI	IntWinStaObjectParse (_In_ PVOID Parameters)
NTSTATUS NTAPI	IntWinStaOkToClose (_In_ PVOID Parameters)
NTSTATUS FASTCALL	IntValidateWindowStationHandle (HWINSTA WindowStation, KPROCESSOR_MODE AccessMode, ACCESS_MASK DesiredAccess, PWINSTATION_OBJECT *Object, POBJECT_HANDLE_INFORMATION pObjectHandleInfo)
NTSTATUS FASTCALL	IntCreateWindowStation (OUT HWINSTA *phWinSta, IN POBJECT_ATTRIBUTES ObjectAttributes, IN KPROCESSOR_MODE AccessMode, IN KPROCESSOR_MODE OwnerMode, IN ACCESS_MASK dwDesiredAccess, DWORD Unknown2, DWORD Unknown3, DWORD Unknown4, DWORD Unknown5, DWORD Unknown6)
PWINSTATION_OBJECT FASTCALL	IntGetProcessWindowStation (HWINSTA *phWinSta OPTIONAL)
BOOL FASTCALL	UserSetProcessWindowStation (HWINSTA hWindowStation)
BOOL FASTCALL	co_IntInitializeDesktopGraphics (VOID)
VOID FASTCALL	IntEndDesktopGraphics (VOID)
BOOL FASTCALL	CheckWinstaAttributeAccess (ACCESS_MASK)

Variables
WINSTATION_OBJECT *	InputWindowStation
HANDLE	gpidLogon
HWND	hwndSAS
UNICODE_STRING	gustrWindowStationsDir

Macro Definition Documentation

SESSION_DIR

#define SESSION_DIR   L"\\Sessions"

Definition at line 4 of file winsta.h.

WINSTA_OBJ_DIR

#define WINSTA_OBJ_DIR   L"\\Windows\\WindowStations"

Definition at line 3 of file winsta.h.

WSS_DYING

#define WSS_DYING   (16)

Definition at line 11 of file winsta.h.

WSS_LOCKED

#define WSS_LOCKED   (1)

Definition at line 7 of file winsta.h.

WSS_NOINTERACTIVE

#define WSS_NOINTERACTIVE   (2)

Definition at line 8 of file winsta.h.

WSS_NOIO

#define WSS_NOIO   (4)

Definition at line 9 of file winsta.h.

WSS_REALSHUTDOWN

#define WSS_REALSHUTDOWN   (32)

Definition at line 12 of file winsta.h.

WSS_SHUTDOWN

#define WSS_SHUTDOWN   (8)

Definition at line 10 of file winsta.h.

Typedef Documentation

PWINSTATION_OBJECT

typedef struct _WINSTATION_OBJECT * PWINSTATION_OBJECT

WINSTATION_OBJECT

typedef struct _WINSTATION_OBJECT WINSTATION_OBJECT

Function Documentation

C_ASSERT() [1/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, Flags)

= =0x10

)

C_ASSERT() [2/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, ptiClipLock)

= =0x18

)

C_ASSERT() [3/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, ptiDrawingClipboard)

= =0x1c

)

C_ASSERT() [4/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, spklList)

= =0x14

)

C_ASSERT() [5/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, spwndClipOpen)

= =0x20

)

C_ASSERT() [6/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, spwndClipOwner)

= =0x28

)

C_ASSERT() [7/7]

C_ASSERT

(

offsetof(WINSTATION_OBJECT, spwndClipViewer)

= =0x24

)

CheckWinstaAttributeAccess()

BOOL FASTCALL CheckWinstaAttributeAccess

(

ACCESS_MASK

DesiredAccess

)

Definition at line 377 of file winsta.c.

{
    PPROCESSINFO ppi = PsGetCurrentProcessWin32Process();
    if ( gpidLogon != PsGetCurrentProcessId() )
    {
        if (!(ppi->W32PF_flags & W32PF_IOWINSTA))
        {
            ERR("Requires Interactive Window Station\n");
            EngSetLastError(ERROR_REQUIRES_INTERACTIVE_WINDOWSTATION);
            return FALSE;
        }
        if (!RtlAreAllAccessesGranted(ppi->amwinsta, DesiredAccess))
        {
            ERR("Access Denied\n");
            EngSetLastError(ERROR_ACCESS_DENIED);
            return FALSE;
        }
    }
    return TRUE;
}

Referenced by NtUserGetClipCursor(), NtUserSetSystemCursor(), and UserClipCursor().

co_IntInitializeDesktopGraphics()

BOOL FASTCALL co_IntInitializeDesktopGraphics

(

VOID

)

Definition at line 262 of file winsta.c.

{
    TEXTMETRICW tmw;
    UNICODE_STRING DriverName = RTL_CONSTANT_STRING(L"DISPLAY");
    PDESKTOP pdesk;
 
    if (PDEVOBJ_lChangeDisplaySettings(NULL, NULL, NULL, &gpmdev, TRUE) != DISP_CHANGE_SUCCESSFUL)
    {
        ERR("PDEVOBJ_lChangeDisplaySettings() failed.\n");
        return FALSE;
    }
 
    ScreenDeviceContext = IntGdiCreateDC(&DriverName, NULL, NULL, NULL, FALSE);
    if (NULL == ScreenDeviceContext)
    {
        IntDestroyPrimarySurface();
        return FALSE;
    }
    GreSetDCOwner(ScreenDeviceContext, GDI_OBJ_HMGR_PUBLIC);
 
    if (!IntCreatePrimarySurface())
    {
        return FALSE;
    }
 
    hSystemBM = NtGdiCreateCompatibleDC(ScreenDeviceContext);
 
    NtGdiSelectFont(hSystemBM, NtGdiGetStockObject(SYSTEM_FONT));
    GreSetDCOwner(hSystemBM, GDI_OBJ_HMGR_PUBLIC);
 
    /* Update the system metrics */
    InitMetrics();
 
    /* Set new size of the monitor */
    UserUpdateMonitorSize((HDEV)gpmdev->ppdevGlobal);
 
    /* Update the SERVERINFO */
    gpsi->aiSysMet[SM_CXSCREEN] = gpmdev->ppdevGlobal->gdiinfo.ulHorzRes;
    gpsi->aiSysMet[SM_CYSCREEN] = gpmdev->ppdevGlobal->gdiinfo.ulVertRes;
    gpsi->Planes        = NtGdiGetDeviceCaps(ScreenDeviceContext, PLANES);
    gpsi->BitsPixel     = NtGdiGetDeviceCaps(ScreenDeviceContext, BITSPIXEL);
    gpsi->BitCount      = gpsi->Planes * gpsi->BitsPixel;
    gpsi->dmLogPixels   = NtGdiGetDeviceCaps(ScreenDeviceContext, LOGPIXELSY);
    if (NtGdiGetDeviceCaps(ScreenDeviceContext, RASTERCAPS) & RC_PALETTE)
    {
        gpsi->PUSIFlags |= PUSIF_PALETTEDISPLAY;
    }
    else
    {
        gpsi->PUSIFlags &= ~PUSIF_PALETTEDISPLAY;
    }
    // Font is realized and this dc was previously set to internal DC_ATTR.
    gpsi->cxSysFontChar = IntGetCharDimensions(hSystemBM, &tmw, (DWORD*)&gpsi->cySysFontChar);
    gpsi->tmSysFont     = tmw;
 
    /* Put the pointer in the center of the screen */
    gpsi->ptCursor.x = gpsi->aiSysMet[SM_CXSCREEN] / 2;
    gpsi->ptCursor.y = gpsi->aiSysMet[SM_CYSCREEN] / 2;
 
    /* Attach monitor */
    UserAttachMonitor((HDEV)gpmdev->ppdevGlobal);
 
    /* Setup the cursor */
    co_IntLoadDefaultCursors();
 
    /* Setup the icons */
    co_IntSetWndIcons();
 
    /* Setup Menu */
    MenuInit();
 
    /* Show the desktop */
    pdesk = IntGetActiveDesktop();
    ASSERT(pdesk);
    co_IntShowDesktop(pdesk, gpsi->aiSysMet[SM_CXSCREEN], gpsi->aiSysMet[SM_CYSCREEN], TRUE);
 
    /* HACK: display wallpaper on all secondary displays */
    {
        PGRAPHICS_DEVICE pGraphicsDevice;
        UNICODE_STRING DriverName = RTL_CONSTANT_STRING(L"DISPLAY");
        UNICODE_STRING DisplayName;
        HDC hdc;
        ULONG iDevNum;
 
        for (iDevNum = 1; (pGraphicsDevice = EngpFindGraphicsDevice(NULL, iDevNum)) != NULL; iDevNum++)
        {
            RtlInitUnicodeString(&DisplayName, pGraphicsDevice->szWinDeviceName);
            hdc = IntGdiCreateDC(&DriverName, &DisplayName, NULL, NULL, FALSE);
            IntPaintDesktop(hdc);
        }
    }
 
    return TRUE;
}

Referenced by co_AddGuiApp().

InitWindowStationImpl()

NTSTATUS NTAPI InitWindowStationImpl

(

VOID

)

Definition at line 34 of file winsta.c.

{
    GENERIC_MAPPING IntWindowStationMapping = { WINSTA_READ,
                                                WINSTA_WRITE,
                                                WINSTA_EXECUTE,
                                                WINSTA_ACCESS_ALL};
 
    /* Set Winsta Object Attributes */
    ExWindowStationObjectType->TypeInfo.DefaultNonPagedPoolCharge = sizeof(WINSTATION_OBJECT);
    ExWindowStationObjectType->TypeInfo.GenericMapping = IntWindowStationMapping;
    ExWindowStationObjectType->TypeInfo.ValidAccessMask = WINSTA_ACCESS_ALL;
 
    return STATUS_SUCCESS;
}

Referenced by DriverEntry().

IntCreateWindowStation()

NTSTATUS FASTCALL IntCreateWindowStation	(	OUT HWINSTA *	phWinSta,
		IN POBJECT_ATTRIBUTES	ObjectAttributes,
		IN KPROCESSOR_MODE	AccessMode,
		IN KPROCESSOR_MODE	OwnerMode,
		IN ACCESS_MASK	dwDesiredAccess,
		DWORD	Unknown2,
		DWORD	Unknown3,
		DWORD	Unknown4,
		DWORD	Unknown5,
		DWORD	Unknown6
	)

Definition at line 447 of file winsta.c.

{
    NTSTATUS Status;
    HWINSTA hWinSta;
    PWINSTATION_OBJECT WindowStation;
 
    TRACE("IntCreateWindowStation called\n");
 
    ASSERT(phWinSta);
    *phWinSta = NULL;
 
    Status = ObOpenObjectByName(ObjectAttributes,
                                ExWindowStationObjectType,
                                AccessMode,
                                NULL,
                                dwDesiredAccess,
                                NULL,
                                (PVOID*)&hWinSta);
    if (NT_SUCCESS(Status))
    {
        TRACE("IntCreateWindowStation opened window station '%wZ'\n",
              ObjectAttributes->ObjectName);
        *phWinSta = hWinSta;
        return Status;
    }
 
    /*
     * No existing window station found, try to create a new one.
     */
 
    /* Create the window station object */
    Status = ObCreateObject(AccessMode,
                            ExWindowStationObjectType,
                            ObjectAttributes,
                            OwnerMode,
                            NULL,
                            sizeof(WINSTATION_OBJECT),
                            0,
                            0,
                            (PVOID*)&WindowStation);
    if (!NT_SUCCESS(Status))
    {
        ERR("ObCreateObject failed for window station '%wZ', Status 0x%08lx\n",
            ObjectAttributes->ObjectName, Status);
        SetLastNtError(Status);
        return Status;
    }
 
    /* Initialize the window station */
    RtlZeroMemory(WindowStation, sizeof(WINSTATION_OBJECT));
 
    InitializeListHead(&WindowStation->DesktopListHead);
    WindowStation->dwSessionId = NtCurrentPeb()->SessionId;
    Status = RtlCreateAtomTable(37, &WindowStation->AtomTable);
    if (!NT_SUCCESS(Status))
    {
        ERR("RtlCreateAtomTable failed for window station '%wZ', Status 0x%08lx\n",
            ObjectAttributes->ObjectName, Status);
        ObDereferenceObject(WindowStation);
        SetLastNtError(Status);
        return Status;
    }
 
    Status = ObInsertObject(WindowStation,
                            NULL,
                            dwDesiredAccess,
                            0,
                            NULL,
                            (PVOID*)&hWinSta);
    if (!NT_SUCCESS(Status))
    {
        ERR("ObInsertObject failed for window station, Status 0x%08lx\n", Status);
        SetLastNtError(Status);
        return Status;
    }
 
    // FIXME! TODO: Add this new window station to a linked list
 
    if (InputWindowStation == NULL)
    {
        ERR("Initializing input window station\n");
 
        /* Only Winlogon can create the interactive window station */
        ASSERT(gpidLogon == PsGetCurrentProcessId());
 
        InputWindowStation = WindowStation;
        WindowStation->Flags &= ~WSS_NOIO;
 
        InitCursorImpl();
 
        UserCreateSystemThread(ST_DESKTOP_THREAD);
        UserCreateSystemThread(ST_RIT);
 
        /* Desktop functions require the desktop thread running so wait for it to initialize */
        UserLeaveCo();
        KeWaitForSingleObject(gpDesktopThreadStartedEvent,
                              UserRequest,
                              UserMode,
                              FALSE,
                              NULL);
        UserEnterCo();
    }
    else
    {
        WindowStation->Flags |= WSS_NOIO;
    }
 
    TRACE("IntCreateWindowStation created window station '%wZ' object 0x%p handle 0x%p\n",
          ObjectAttributes->ObjectName, WindowStation, hWinSta);
 
    *phWinSta = hWinSta;
    EngSetLastError(ERROR_SUCCESS);
 
    return STATUS_SUCCESS;
}

Referenced by IntResolveDesktop(), and NtUserCreateWindowStation().

IntEndDesktopGraphics()

VOID FASTCALL IntEndDesktopGraphics

(

VOID

)

Definition at line 358 of file winsta.c.

{
    if (NULL != ScreenDeviceContext)
    {  // No need to allocate a new dcattr.
        GreSetDCOwner(ScreenDeviceContext, GDI_OBJ_HMGR_POWNED);
        GreDeleteObject(ScreenDeviceContext);
        ScreenDeviceContext = NULL;
    }
    IntHideDesktop(IntGetActiveDesktop());
    IntDestroyPrimarySurface();
}

Referenced by RemoveGuiApp().

IntGetProcessWindowStation()

PWINSTATION_OBJECT FASTCALL IntGetProcessWindowStation

(

HWINSTA *phWinSta

OPTIONAL

)

Definition at line 400 of file winsta.c.

{
    PWINSTATION_OBJECT pWinSta;
    PPROCESSINFO ppi = GetW32ProcessInfo();
    HWINSTA hWinSta = ppi->hwinsta;
    if (phWinSta)
        *phWinSta = hWinSta;
    IntValidateWindowStationHandle(hWinSta, UserMode, 0, &pWinSta, 0);
    return pWinSta;
}

Referenced by NtUserActivateKeyboardLayout(), NtUserGetImeInfoEx(), NtUserGetKeyboardLayoutList(), NtUserLoadKeyboardLayoutEx(), NtUserSetImeInfoEx(), NtUserUnloadKeyboardLayout(), and UserSetDefaultInputLang().

IntValidateWindowStationHandle()

NTSTATUS FASTCALL IntValidateWindowStationHandle	(	HWINSTA	WindowStation,
		KPROCESSOR_MODE	AccessMode,
		ACCESS_MASK	DesiredAccess,
		PWINSTATION_OBJECT *	Object,
		POBJECT_HANDLE_INFORMATION	pObjectHandleInfo
	)

Definition at line 232 of file winsta.c.

{
    NTSTATUS Status;
 
    if (WindowStation == NULL)
    {
        ERR("Invalid window station handle\n");
        EngSetLastError(ERROR_INVALID_HANDLE);
        return STATUS_INVALID_HANDLE;
    }
 
    Status = ObReferenceObjectByHandle(WindowStation,
                                       DesiredAccess,
                                       ExWindowStationObjectType,
                                       AccessMode,
                                       (PVOID*)Object,
                                       pObjectHandleInfo);
 
    if (!NT_SUCCESS(Status))
        SetLastNtError(Status);
 
    return Status;
}

Referenced by BuildDesktopNameList(), IntGetProcessWindowStation(), IntGetWinStaForCbAccess(), NtUserCloseWindowStation(), NtUserLockWindowStation(), NtUserSetShellWindowEx(), NtUserSetWindowsHookEx(), NtUserSetWindowStationUser(), NtUserUnlockWindowStation(), UserCreateMenu(), UserGetShellWindow(), and UserSetProcessWindowStation().

IntWinStaObjectDelete()

NTSTATUS NTAPI IntWinStaObjectDelete

(

_In_ PVOID

Parameters

)

Definition at line 106 of file winsta.c.

{
    PWIN32_DELETEMETHOD_PARAMETERS DeleteParameters = Parameters;
    PWINSTATION_OBJECT WinSta = (PWINSTATION_OBJECT)DeleteParameters->Object;
 
    TRACE("Deleting window station 0x%p\n", WinSta);
 
    if (WinSta == InputWindowStation)
    {
        ERR("WARNING: Deleting the interactive window station '%wZ'!\n",
            &(OBJECT_HEADER_TO_NAME_INFO(OBJECT_TO_OBJECT_HEADER(InputWindowStation))->Name));
 
        /* Only Winlogon can close and delete the interactive window station */
        ASSERT(gpidLogon == PsGetCurrentProcessId());
 
        InputWindowStation = NULL;
    }
 
    WinSta->Flags |= WSS_DYING;
 
    UserEmptyClipboardData(WinSta);
 
    RtlDestroyAtomTable(WinSta->AtomTable);
 
    UserAssignmentUnlock((PVOID*)&WinSta->spklList);
 
    return STATUS_SUCCESS;
}

Referenced by DriverEntry().

IntWinStaObjectParse()

NTSTATUS NTAPI IntWinStaObjectParse

(

_In_ PVOID

Parameters

)

Definition at line 138 of file winsta.c.

{
    PWIN32_PARSEMETHOD_PARAMETERS ParseParameters = Parameters;
    PUNICODE_STRING RemainingName = ParseParameters->RemainingName;
 
    /* Assume we don't find anything */
    *ParseParameters->Object = NULL;
 
    /* Check for an empty name */
    if (!RemainingName->Length)
    {
        /* Make sure this is a window station, can't parse a desktop now */
        if (ParseParameters->ObjectType != ExWindowStationObjectType)
        {
            /* Fail */
            return STATUS_OBJECT_TYPE_MISMATCH;
        }
 
        /* Reference the window station and return */
        ObReferenceObject(ParseParameters->ParseObject);
        *ParseParameters->Object = ParseParameters->ParseObject;
        return STATUS_SUCCESS;
    }
 
    /* Check for leading slash */
    if (RemainingName->Buffer[0] == OBJ_NAME_PATH_SEPARATOR)
    {
        /* Skip it */
        RemainingName->Buffer++;
        RemainingName->Length -= sizeof(WCHAR);
        RemainingName->MaximumLength -= sizeof(WCHAR);
    }
 
    /* Check if there is still a slash */
    if (wcschr(RemainingName->Buffer, OBJ_NAME_PATH_SEPARATOR))
    {
        /* In this case, fail */
        return STATUS_OBJECT_PATH_INVALID;
    }
 
    /*
     * Check if we are parsing a desktop.
     */
    if (ParseParameters->ObjectType == ExDesktopObjectType)
    {
        /* Then call the desktop parse routine */
        return IntDesktopObjectParse(ParseParameters->ParseObject,
                                     ParseParameters->ObjectType,
                                     ParseParameters->AccessState,
                                     ParseParameters->AccessMode,
                                     ParseParameters->Attributes,
                                     ParseParameters->CompleteName,
                                     RemainingName,
                                     ParseParameters->Context,
                                     ParseParameters->SecurityQos,
                                     ParseParameters->Object);
    }
 
    /* Should hopefully never get here */
    return STATUS_OBJECT_TYPE_MISMATCH;
}

Referenced by DriverEntry().

IntWinStaOkToClose()

NTSTATUS NTAPI IntWinStaOkToClose

(

_In_ PVOID

Parameters

)

Definition at line 203 of file winsta.c.

{
    PWIN32_OKAYTOCLOSEMETHOD_PARAMETERS OkToCloseParameters = Parameters;
    PPROCESSINFO ppi;
 
    ppi = PsGetCurrentProcessWin32Process();
 
    if (ppi && (OkToCloseParameters->Handle == ppi->hwinsta))
    {
        return STATUS_ACCESS_DENIED;
    }
 
    return STATUS_SUCCESS;
}

Referenced by DriverEntry().

UserCreateWinstaDirectory()

NTSTATUS NTAPI UserCreateWinstaDirectory

(

VOID

)

Definition at line 51 of file winsta.c.

{
    NTSTATUS Status;
    PPEB Peb;
    OBJECT_ATTRIBUTES ObjectAttributes;
    HANDLE hWinstaDir;
    WCHAR wstrWindowStationsDir[MAX_PATH];
 
    /* Create the WindowStations directory and cache its path for later use */
    Peb = NtCurrentPeb();
    if(Peb->SessionId == 0)
    {
        if (!RtlCreateUnicodeString(&gustrWindowStationsDir, WINSTA_OBJ_DIR))
        {
            return STATUS_INSUFFICIENT_RESOURCES;
        }
    }
    else
    {
        Status = RtlStringCbPrintfW(wstrWindowStationsDir,
                                    sizeof(wstrWindowStationsDir),
                                    L"%ws\\%lu%ws",
                                    SESSION_DIR,
                                    Peb->SessionId,
                                    WINSTA_OBJ_DIR);
        if (!NT_SUCCESS(Status))
            return Status;
 
        if (!RtlCreateUnicodeString(&gustrWindowStationsDir, wstrWindowStationsDir))
        {
            return STATUS_INSUFFICIENT_RESOURCES;
        }
    }
 
    InitializeObjectAttributes(&ObjectAttributes,
                               &gustrWindowStationsDir,
                               OBJ_KERNEL_HANDLE,
                               NULL,
                               NULL);
    Status = ZwCreateDirectoryObject(&hWinstaDir, DIRECTORY_CREATE_OBJECT, &ObjectAttributes);
    if (!NT_SUCCESS(Status))
    {
        ERR("Could not create %wZ directory (Status 0x%X)\n", &gustrWindowStationsDir,  Status);
        return Status;
    }
 
    TRACE("Created directory %wZ for session %lu\n", &gustrWindowStationsDir, Peb->SessionId);
 
    return Status;
}

Referenced by UserInitialize().

UserSetProcessWindowStation()

BOOL FASTCALL UserSetProcessWindowStation

(

HWINSTA

hWindowStation

)

Definition at line 1382 of file winsta.c.

{
    NTSTATUS Status;
    PPROCESSINFO ppi;
    OBJECT_HANDLE_INFORMATION ObjectHandleInfo;
    PWINSTATION_OBJECT NewWinSta = NULL, OldWinSta;
    HWINSTA hCacheWinSta;
 
    ppi = PsGetCurrentProcessWin32Process();
 
    /* Reference the new window station */
    if (hWindowStation != NULL)
    {
        Status = IntValidateWindowStationHandle(hWindowStation,
                                                UserMode,
                                                0,
                                                &NewWinSta,
                                                &ObjectHandleInfo);
        if (!NT_SUCCESS(Status))
        {
            TRACE("Validation of window station handle 0x%p failed\n", hWindowStation);
            SetLastNtError(Status);
            return FALSE;
        }
    }
 
    OldWinSta = ppi->prpwinsta;
    hCacheWinSta = PsGetProcessWin32WindowStation(ppi->peProcess);
 
    /* Dereference the previous window station */
    if (OldWinSta != NULL)
    {
        ObDereferenceObject(OldWinSta);
    }
 
    /*
     * FIXME: Don't allow changing the window station if there are threads that are attached to desktops and own GUI objects?
     */
 
    /* Close the cached EPROCESS window station handle if needed */
    if (hCacheWinSta != NULL)
    {
        /* Reference the window station */
        Status = ObReferenceObjectByHandle(hCacheWinSta,
                                           0,
                                           ExWindowStationObjectType,
                                           UserMode,
                                           (PVOID*)&OldWinSta,
                                           NULL);
        if (!NT_SUCCESS(Status))
        {
            ERR("Failed to reference the inherited window station, Status 0x%08lx\n", Status);
            /* We failed, reset the cache */
            hCacheWinSta = NULL;
            PsSetProcessWindowStation(ppi->peProcess, hCacheWinSta);
        }
        else
        {
            /*
             * Close the old handle and reset the cache only
             * if we are setting a different window station.
             */
            if (NewWinSta != OldWinSta)
            {
                ObCloseHandle(hCacheWinSta, UserMode);
                hCacheWinSta = NULL;
                PsSetProcessWindowStation(ppi->peProcess, hCacheWinSta);
            }
 
            /* Dereference the window station */
            ObDereferenceObject(OldWinSta);
        }
    }
 
    /* Duplicate and save a new cached EPROCESS window station handle */
    if ((hCacheWinSta == NULL) && (hWindowStation != NULL))
    {
        Status = ZwDuplicateObject(ZwCurrentProcess(),
                                   hWindowStation,
                                   ZwCurrentProcess(),
                                   (PHANDLE)&hCacheWinSta,
                                   0,
                                   0,
                                   DUPLICATE_SAME_ACCESS);
        if (!NT_SUCCESS(Status))
        {
            ERR("UserSetProcessWindowStation: Failed to duplicate the window station handle, Status 0x%08lx\n", Status);
        }
        else
        {
            PsSetProcessWindowStation(ppi->peProcess, hCacheWinSta);
        }
    }
 
    ppi->prpwinsta = NewWinSta;
    ppi->hwinsta = hWindowStation;
    ppi->amwinsta = hWindowStation != NULL ? ObjectHandleInfo.GrantedAccess : 0;
    TRACE("WS : Granted Access 0x%08lx\n",ppi->amwinsta);
 
    if (RtlAreAllAccessesGranted(ppi->amwinsta, WINSTA_READSCREEN))
    {
        ppi->W32PF_flags |= W32PF_READSCREENACCESSGRANTED;
    }
    else
    {
        ppi->W32PF_flags &= ~W32PF_READSCREENACCESSGRANTED;
    }
 
    if (NewWinSta && !(NewWinSta->Flags & WSS_NOIO))
    {
        ppi->W32PF_flags |= W32PF_IOWINSTA;
    }
    else /* Might be closed if the handle is NULL */
    {
        ppi->W32PF_flags &= ~W32PF_IOWINSTA;
    }
    return TRUE;
}

Referenced by InitThreadCallback(), NtUserSetProcessWindowStation(), RawInputThreadMain(), and UserProcessDestroy().

Variable Documentation

gpidLogon

HANDLE gpidLogon

extern

Definition at line 15 of file simplecall.c.

Referenced by CheckWinstaAttributeAccess(), co_IntCreateDefaultImeWindow(), co_IntRegisterLogonProcess(), InitThreadCallback(), IntCreateWindowStation(), IntWinStaObjectDelete(), NtUserGetThreadState(), NtUserLockWindowStation(), NtUserSetLogonNotifyWindow(), NtUserSetWindowStationUser(), NtUserSwitchDesktop(), NtUserUnlockWindowStation(), UserInitiateShutdown(), and UserProcessDestroy().

gustrWindowStationsDir

UNICODE_STRING gustrWindowStationsDir

extern

Definition at line 27 of file winsta.c.

Referenced by BuildUserModeWindowStationName(), BuildWindowStationNameList(), IntResolveDesktop(), and UserCreateWinstaDirectory().

hwndSAS

HWND hwndSAS

extern

Definition at line 24 of file winsta.c.

Referenced by DefWndHandleSetCursor(), DefWndHandleSysCommand(), DoTheScreenSaver(), ExitThreadCallback(), IntDefWindowProc(), MENU_TrackKbdMenuBar(), MENU_TrackMenu(), NotifyLogon(), NtUserCallOneParam(), NtUserLockWorkStation(), NtUserSetLogonNotifyWindow(), RegisterHotKeys(), UnregisterHotKeys(), UserEndShutdown(), and UserInitiateShutdown().

InputWindowStation

WINSTATION_OBJECT* InputWindowStation

extern

Definition at line 21 of file winsta.c.

Referenced by co_UserProcessHotKeys(), InitThreadCallback(), IntCreateWindowStation(), IntResolveDesktop(), IntWinStaObjectDelete(), NtUserMessageCall(), NtUserSwitchDesktop(), RawInputThreadMain(), and UserOpenInputDesktop().