The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

OpenWindowStation function

Opens the specified window station.

Syntax

C++


HWINSTA WINAPI OpenWindowStation(
  _In_ LPTSTR      lpszWinSta,
  _In_ BOOL        fInherit,
  _In_ ACCESS_MASK dwDesiredAccess
);

Parameters

lpszWinSta [in]

The name of the window station to be opened. Window station names are case-insensitive.

This window station must belong to the current session.

fInherit [in]

If this value is TRUE, processes created by this process will inherit the handle. Otherwise, the processes do not inherit this handle.

dwDesiredAccess [in]

The access to the window station. For a list of access rights, see Window Station Security and Access Rights.

Return value

If the function succeeds, the return value is the handle to the specified window station.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

After you are done with the handle, you must call CloseWindowStation to free the handle.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll
Unicode and ANSI names	OpenWindowStationW (Unicode) and OpenWindowStationA (ANSI)