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 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

See Also

CreateWindowStation

GetProcessWindowStation

OpenWindowStation

SetThreadDesktop

Window Station and Desktop Functions

Window Stations

Send comments about this topic to Microsoft

Build date: 10/8/2009