SetProcessWindowStation Function

Assigns the specified window station to the calling process. This enables the process to access objects in the window station such as desktops, the clipboard, and global atoms. All subsequent operations on the window station use the access rights granted to hWinSta.

Syntax

C++
BOOL WINAPI SetProcessWindowStation(
  __in  HWINSTA hWinSta
);

Parameters

hWinSta [in]

A handle to the window station. This can be a handle returned by the CreateWindowStation, OpenWindowStation, or GetProcessWindowStation function.

This window station must be associated with the current session.

Return Value

If the function succeeds, the return value is nonzero.

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

Requirements

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWinuser.h (include Windows.h)
LibraryUser32.lib
DLLUser32.dll

See Also

CreateWindowStation
GetProcessWindowStation
OpenWindowStation
SetThreadDesktop
Window Station and Desktop Functions
Window Stations

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags :


Page view tracker