GetProcessWindowStation function (winuser.h)
Retrieves a handle to the current window station for the calling process.
Syntax
HWINSTA GetProcessWindowStation();
Return value
If the function succeeds, the return value is a handle to the window station.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
Remarks
The system associates a window station with a process when the process is created. A process can use the SetProcessWindowStation function to change its window station.
The calling process can use the returned handle in calls to the GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation, and SetUserObjectSecurity functions.
Do not close the handle returned by this function.
A service application is created with an associated window station and desktop, so there is no need to call a USER or GDI function to connect the service to a window station and desktop.
Requirements
| Requirement | Value |
|---|---|
| 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 |
| API set | ext-ms-win-ntuser-windowstation-l1-1-0 (introduced in Windows 8) |