winsta.c File Reference

#include <user32.h>

Include dependency graph for winsta.c:

Go to the source code of this file.

Classes
struct	tagENUMNAMESASCIICONTEXT

Typedefs
typedef struct tagENUMNAMESASCIICONTEXT	ENUMNAMESASCIICONTEXT
typedef struct tagENUMNAMESASCIICONTEXT *	PENUMNAMESASCIICONTEXT

Functions
	WINE_DEFAULT_DEBUG_CHANNEL (winsta)
HWINSTA WINAPI	CreateWindowStationA (IN LPCSTR lpwinsta OPTIONAL, IN DWORD dwReserved, IN ACCESS_MASK dwDesiredAccess, IN LPSECURITY_ATTRIBUTES lpsa OPTIONAL)
HWINSTA WINAPI	CreateWindowStationW (IN LPCWSTR lpwinsta OPTIONAL, IN DWORD dwReserved, IN ACCESS_MASK dwDesiredAccess, IN LPSECURITY_ATTRIBUTES lpsa OPTIONAL)
BOOL FASTCALL	EnumNamesW (HWINSTA WindowStation, NAMEENUMPROCW EnumFunc, LPARAM Context, BOOL Desktops)
BOOL CALLBACK	EnumNamesCallback (LPWSTR Name, LPARAM Param)
BOOL FASTCALL	EnumNamesA (HWINSTA WindowStation, NAMEENUMPROCA EnumFunc, LPARAM Context, BOOL Desktops)
BOOL WINAPI	EnumWindowStationsA (IN WINSTAENUMPROCA EnumFunc, IN LPARAM Context)
BOOL WINAPI	EnumWindowStationsW (IN WINSTAENUMPROCW EnumFunc, IN LPARAM Context)
BOOL WINAPI	GetWinStationInfo (PVOID pUnknown)
HWINSTA WINAPI	OpenWindowStationA (IN LPCSTR lpszWinSta, IN BOOL fInherit, IN ACCESS_MASK dwDesiredAccess)
HWINSTA WINAPI	OpenWindowStationW (IN LPCWSTR lpszWinSta, IN BOOL fInherit, IN ACCESS_MASK dwDesiredAccess)
BOOL WINAPI	SetWindowStationUser (IN HWINSTA hWindowStation, IN PLUID pluid, IN PSID psid OPTIONAL, IN DWORD size)

Typedef Documentation

ENUMNAMESASCIICONTEXT

typedef struct tagENUMNAMESASCIICONTEXT ENUMNAMESASCIICONTEXT

PENUMNAMESASCIICONTEXT

typedef struct tagENUMNAMESASCIICONTEXT * PENUMNAMESASCIICONTEXT

Function Documentation

CreateWindowStationA()

HWINSTA WINAPI CreateWindowStationA	(	IN LPCSTR lpwinsta	OPTIONAL,
		IN DWORD	dwReserved,
		IN ACCESS_MASK	dwDesiredAccess,
		IN LPSECURITY_ATTRIBUTES lpsa	OPTIONAL
	)

Definition at line 18 of file winsta.c.

{
    HWINSTA hWinSta;
    UNICODE_STRING WindowStationNameU;
 
    if (lpwinsta)
    {
        /* After conversion, the buffer is zero-terminated */
        RtlCreateUnicodeStringFromAsciiz(&WindowStationNameU, lpwinsta);
    }
    else
    {
        RtlInitUnicodeString(&WindowStationNameU, NULL);
    }
 
    hWinSta = CreateWindowStationW(WindowStationNameU.Buffer,
                                   dwReserved,
                                   dwDesiredAccess,
                                   lpsa);
 
    /* Free the string if it was allocated */
    if (lpwinsta) RtlFreeUnicodeString(&WindowStationNameU);
 
    return hWinSta;
}

CreateWindowStationW()

HWINSTA WINAPI CreateWindowStationW	(	IN LPCWSTR lpwinsta	OPTIONAL,
		IN DWORD	dwReserved,
		IN ACCESS_MASK	dwDesiredAccess,
		IN LPSECURITY_ATTRIBUTES lpsa	OPTIONAL
	)

Definition at line 54 of file winsta.c.

{
    NTSTATUS Status;
    HWINSTA hWinSta;
    UNICODE_STRING WindowStationName;
    // FIXME: We should cache a per-session directory (see ntuser\winsta.c!UserCreateWinstaDirectory).
    UNICODE_STRING WindowStationsDir = RTL_CONSTANT_STRING(L"\\Windows\\WindowStations");
    OBJECT_ATTRIBUTES ObjectAttributes;
    HANDLE hWindowStationsDir;
 
    /*
     * If provided, the window station name is always relative to the
     * current user session's WindowStations directory.
     * Otherwise (the window station name is NULL or an empty string),
     * pass both an empty string and no WindowStations directory handle
     * to win32k, so that it will create a window station whose name
     * is based on the logon session identifier for the calling process.
     */
    if (lpwinsta && *lpwinsta)
    {
        /* Open WindowStations directory */
        InitializeObjectAttributes(&ObjectAttributes,
                                   &WindowStationsDir,
                                   OBJ_CASE_INSENSITIVE,
                                   NULL,
                                   NULL);
 
        Status = NtOpenDirectoryObject(&hWindowStationsDir,
                                       DIRECTORY_CREATE_OBJECT,
                                       &ObjectAttributes);
        if (!NT_SUCCESS(Status))
        {
            ERR("Failed to open WindowStations directory\n");
            return NULL;
        }
 
        RtlInitUnicodeString(&WindowStationName, lpwinsta);
    }
    else
    {
        lpwinsta = NULL;
        hWindowStationsDir = NULL;
    }
 
    /* Create the window station object */
    InitializeObjectAttributes(&ObjectAttributes,
                               lpwinsta ? &WindowStationName : NULL,
                               OBJ_CASE_INSENSITIVE | OBJ_OPENIF,
                               hWindowStationsDir,
                               lpsa ? lpsa->lpSecurityDescriptor : NULL);
 
    /* Check if the handle should be inheritable */
    if (lpsa && lpsa->bInheritHandle)
    {
        ObjectAttributes.Attributes |= OBJ_INHERIT;
    }
 
    hWinSta = NtUserCreateWindowStation(&ObjectAttributes,
                                        dwDesiredAccess,
                                        0, 0, 0, 0, 0);
 
    if (hWindowStationsDir)
        NtClose(hWindowStationsDir);
 
    return hWinSta;
}

Referenced by CreateWindowStationA().

EnumNamesA()

BOOL FASTCALL EnumNamesA	(	HWINSTA	WindowStation,
		NAMEENUMPROCA	EnumFunc,
		LPARAM	Context,
		BOOL	Desktops
	)

Definition at line 273 of file winsta.c.

{
    ENUMNAMESASCIICONTEXT PrivateContext;
 
    PrivateContext.UserEnumFunc = EnumFunc;
    PrivateContext.UserContext = Context;
 
    return EnumNamesW(WindowStation, EnumNamesCallback, (LPARAM) &PrivateContext, Desktops);
}

Referenced by EnumDesktopsA(), and EnumWindowStationsA().

EnumNamesCallback()

BOOL CALLBACK EnumNamesCallback	(	LPWSTR	Name,
		LPARAM	Param
	)

Definition at line 211 of file winsta.c.

{
    PENUMNAMESASCIICONTEXT Context = (PENUMNAMESASCIICONTEXT) Param;
    CHAR FixedNameA[32];
    LPSTR NameA;
    INT Len;
    BOOL Ret;
 
    /*
     * Determine required size of Ascii string and see
     * if we can use fixed buffer.
     */
    Len = WideCharToMultiByte(CP_ACP, 0, Name, -1, NULL, 0, NULL, NULL);
    if (Len <= 0)
    {
        /* Some strange error occured */
        return FALSE;
    }
    else if (Len <= sizeof(FixedNameA))
    {
        /* Fixed-size buffer is large enough */
        NameA = FixedNameA;
    }
    else
    {
        /* Allocate a larger buffer */
        NameA = HeapAlloc(GetProcessHeap(), 0, Len);
        if (NULL == NameA)
        {
            SetLastError(ERROR_NOT_ENOUGH_MEMORY);
            return FALSE;
        }
    }
 
    /* Do the Unicode ->Ascii conversion */
    if (0 == WideCharToMultiByte(CP_ACP, 0, Name, -1, NameA, Len, NULL, NULL))
    {
        /* Something went wrong, clean up */
        if (NameA != FixedNameA)
        {
            HeapFree(GetProcessHeap(), 0, NameA);
        }
        return FALSE;
    }
 
    /* Call user callback */
    Ret = Context->UserEnumFunc(NameA, Context->UserContext);
 
    /* Cleanup */
    if (NameA != FixedNameA)
    {
        HeapFree(GetProcessHeap(), 0, NameA);
    }
 
    return Ret;
}

Referenced by EnumNamesA().

EnumNamesW()

BOOL FASTCALL EnumNamesW	(	HWINSTA	WindowStation,
		NAMEENUMPROCW	EnumFunc,
		LPARAM	Context,
		BOOL	Desktops
	)

Definition at line 130 of file winsta.c.

{
    CHAR Buffer[256];
    PVOID NameList;
    PWCHAR Name;
    NTSTATUS Status;
    ULONG RequiredSize;
    ULONG CurrentEntry, EntryCount;
    BOOL Ret;
 
    /* Check parameters */
    if (WindowStation == NULL && Desktops)
    {
        WindowStation = GetProcessWindowStation();
    }
 
    /* Try with fixed-size buffer */
    Status = NtUserBuildNameList(WindowStation, sizeof(Buffer), Buffer, &RequiredSize);
    if (NT_SUCCESS(Status))
    {
        /* Fixed-size buffer is large enough */
        NameList = (PWCHAR) Buffer;
    }
    else if (Status == STATUS_BUFFER_TOO_SMALL)
    {
        /* Allocate a larger buffer */
        NameList = HeapAlloc(GetProcessHeap(), 0, RequiredSize);
        if (NameList == NULL)
            return FALSE;
 
        /* Try again */
        Status = NtUserBuildNameList(WindowStation, RequiredSize, NameList, NULL);
        if (!NT_SUCCESS(Status))
        {
            HeapFree(GetProcessHeap(), 0, NameList);
            SetLastError(RtlNtStatusToDosError(Status));
            return FALSE;
        }
    }
    else
    {
        /* Some unrecognized error occured */
        SetLastError(RtlNtStatusToDosError(Status));
        return FALSE;
    }
 
    /* Enum the names one by one */
    EntryCount = *((DWORD *) NameList);
    Name = (PWCHAR) ((PCHAR) NameList + sizeof(DWORD));
    Ret = TRUE;
    for (CurrentEntry = 0; CurrentEntry < EntryCount && Ret; ++CurrentEntry)
    {
        Ret = (*EnumFunc)(Name, Context);
        Name += wcslen(Name) + 1;
    }
 
    /* Cleanup */
    if (NameList != Buffer)
    {
        HeapFree(GetProcessHeap(), 0, NameList);
    }
 
    return Ret;
}

Referenced by EnumDesktopsW(), EnumNamesA(), and EnumWindowStationsW().

EnumWindowStationsA()

BOOL WINAPI EnumWindowStationsA	(	IN WINSTAENUMPROCA	EnumFunc,
		IN LPARAM	Context
	)

Definition at line 291 of file winsta.c.

{
    return EnumNamesA(NULL, EnumFunc, Context, FALSE);
}

EnumWindowStationsW()

BOOL WINAPI EnumWindowStationsW	(	IN WINSTAENUMPROCW	EnumFunc,
		IN LPARAM	Context
	)

Definition at line 304 of file winsta.c.

{
    return EnumNamesW(NULL, EnumFunc, Context, FALSE);
}

GetWinStationInfo()

BOOL WINAPI GetWinStationInfo

(

PVOID

pUnknown

)

Definition at line 317 of file winsta.c.

{
    return (BOOL)NtUserCallOneParam((DWORD_PTR)pUnknown, ONEPARAM_ROUTINE_GETWINSTAINFO);
}

OpenWindowStationA()

HWINSTA WINAPI OpenWindowStationA	(	IN LPCSTR	lpszWinSta,
		IN BOOL	fInherit,
		IN ACCESS_MASK	dwDesiredAccess
	)

Definition at line 328 of file winsta.c.

{
    HWINSTA hWinSta;
    UNICODE_STRING WindowStationNameU;
 
    if (lpszWinSta)
    {
        /* After conversion, the buffer is zero-terminated */
        RtlCreateUnicodeStringFromAsciiz(&WindowStationNameU, lpszWinSta);
    }
    else
    {
        RtlInitUnicodeString(&WindowStationNameU, NULL);
    }
 
    hWinSta = OpenWindowStationW(WindowStationNameU.Buffer,
                                 fInherit,
                                 dwDesiredAccess);
 
    /* Free the string if it was allocated */
    if (lpszWinSta) RtlFreeUnicodeString(&WindowStationNameU);
 
    return hWinSta;
}

OpenWindowStationW()

HWINSTA WINAPI OpenWindowStationW	(	IN LPCWSTR	lpszWinSta,
		IN BOOL	fInherit,
		IN ACCESS_MASK	dwDesiredAccess
	)

Definition at line 362 of file winsta.c.

{
    NTSTATUS Status;
    HWINSTA hWinSta;
    UNICODE_STRING WindowStationName;
    // FIXME: We should cache a per-session directory (see ntuser\winsta.c!UserCreateWinstaDirectory).
    UNICODE_STRING WindowStationsDir = RTL_CONSTANT_STRING(L"\\Windows\\WindowStations");
    OBJECT_ATTRIBUTES ObjectAttributes;
    HANDLE hWindowStationsDir;
 
    /* Open WindowStations directory */
    InitializeObjectAttributes(&ObjectAttributes,
                               &WindowStationsDir,
                               OBJ_CASE_INSENSITIVE,
                               NULL,
                               NULL);
 
    Status = NtOpenDirectoryObject(&hWindowStationsDir,
                                   DIRECTORY_TRAVERSE,
                                   &ObjectAttributes);
    if(!NT_SUCCESS(Status))
    {
        ERR("Failed to open WindowStations directory\n");
        return NULL;
    }
 
    /* Open the window station object */
    RtlInitUnicodeString(&WindowStationName, lpszWinSta);
 
    InitializeObjectAttributes(&ObjectAttributes,
                               &WindowStationName,
                               OBJ_CASE_INSENSITIVE,
                               hWindowStationsDir,
                               NULL);
 
    /* Check if the handle should be inheritable */
    if (fInherit)
    {
        ObjectAttributes.Attributes |= OBJ_INHERIT;
    }
 
    hWinSta = NtUserOpenWindowStation(&ObjectAttributes, dwDesiredAccess);
 
    NtClose(hWindowStationsDir);
 
    return hWinSta;
}

Referenced by OpenWindowStationA().

SetWindowStationUser()

BOOL WINAPI SetWindowStationUser	(	IN HWINSTA	hWindowStation,
		IN PLUID	pluid,
		IN PSID psid	OPTIONAL,
		IN DWORD	size
	)

Definition at line 419 of file winsta.c.

{
    BOOL Success;
 
    Success = NtUserSetWindowStationUser(hWindowStation, pluid, psid, size);
    if (Success)
    {
        /* Signal log-on/off to WINSRV */
 
        /* User is logging on if *pluid != LuidNone, otherwise it is a log-off */
        LUID LuidNone = {0, 0};
        BOOL IsLogon = (pluid && !RtlEqualLuid(pluid, &LuidNone));
 
        Logon(IsLogon);
    }
 
    return Success;
}

Referenced by AllowAccessOnSession(), CreateWindowStationAndDesktops(), HandleLogoff(), and HandleLogon().

WINE_DEFAULT_DEBUG_CHANNEL()

WINE_DEFAULT_DEBUG_CHANNEL

(

winsta

)