OpenWindowStation
The OpenWindowStation
function returns a handle to an existing window station.
HWINSTA OpenWindowStation(
|
LPTSTR lpszWinSta, |
// name of the
window station to open |
|
BOOL fInherit, |
// specifies
whether returned handle is inheritable |
|
DWORD dwDesiredAccess |
// specifies access
of returned handle |
|
); |
|
Parameters
lpszWinSta
Points to a
null-terminated string specifying the name of the window station to be opened.
Window station names are case-insensitive.
fInherit
Specifies
whether the returned handle is inherited when a new process is created. If this
value is TRUE, new processes will inherit the handle.
dwDesiredAccess
Specifies the
type of access to the window station. This parameter can be one or more of the
following values:
|
Value |
Description |
|
WINSTA_ACCESSCLIPBOARD |
Required to
use the clipboard. |
|
WINSTA_ACCESSGLOBALATOMS |
Required to
manipulate global atoms. |
|
WINSTA_CREATEDESKTOP |
Required to
create new desktop objects on the window station. |
|
WINSTA_ENUMDESKTOPS |
Required to
enumerate existing desktop objects. |
|
WINSTA_ENUMERATE |
Required
for the window station to be enumerated. |
|
WINSTA_EXITWINDOWS |
Required to
successfully call the ExitWindows and ExitWindowsEx functions. |
|
WINSTA_READATTRIBUTES |
Required to
read the attributes of a window station object. |
|
WINSTA_READSCREEN |
Required to
access screen contents. |
|
WINSTA_WRITEATTRIBUTES |
Required to
modify the attributes of a window station object. |
Return Values
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.
See Also