SetProcessWindowStation

The SetProcessWindowStation function assigns a 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.

BOOL SetProcessWindowStation(
  HWINSTA hWinSta  // handle to window station to assign to this process
);
 

Parameters

hWinSta

Handle to the window station to be assigned to the calling process. This can be a handle returned by the CreateWindowStation, OpenWindowStation, or GetProcessWindowStation functions.

Return Values

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.

QuickInfo

  Windows NT: Requires version 3.51 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Window Stations and Desktops Overview, Window Station and Desktop Functions, CreateWindowStation, GetProcessWindowStation, OpenWindowStation, SetThreadDesktop