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

BOOL SetProcessWindowStation(
  HWINSTA hWinSta
);

Parameters

hWinSta

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 client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll

See Also

CreateWindowStation

GetProcessWindowStation

OpenWindowStation

SetThreadDesktop

Window Station and Desktop Functions

Window Stations