Desktops and Window stations

Commands related to desktops and window stations

SYNOPSIS

package require twapi_winsta
close_desktop_handle HDESK
close_window_station_handle HWINSTA
find_desktops ?-winsta WINSTA?
find_window_stations
get_current_window_station_handle
get_desktop_handle DESKTOP ?-inherit BOOL? ?-access ACCESSRIGHTS? ?-allowhooks BOOL?
get_desktop_name HDESK
get_desktop_user_sid HDESK
get_window_station_handle WINDOWSTATION ?-inherit BOOL? ?-access ACCESSRIGHTS?
get_window_station_name HWINSTA
get_window_station_user_sid HWINSTA
set_process_window_station HWINSTA

DESCRIPTION

This package provides procedures related to desktops and window stations on Windows platforms.

Commands

close_desktop_handle HDESK
Closes a desktop handle that was previously returned by a call to get_desktop_handle and frees and associated resources.
close_window_station_handle HWINSTA
Closes a window station handle that was previously returned by a call to get_window_station_handle.
find_desktops ?-winsta WINSTA?
Returns a list of desktops. By default, the desktops from the current window station are returned. The -winsta option may be used to specify a different window station whose id is WINSTA.
find_window_stations
Returns a list of identifiers for all window stations in the system for which the caller has the WINSTA_ENUMERATE privilege.
get_current_window_station_handle
Returns a handle to the window station for the calling process. This handle need not (and should not) be closed.
get_desktop_handle DESKTOP ?-inherit BOOL? ?-access ACCESSRIGHTS? ?-allowhooks BOOL?
Returns a handle to the specified desktop.

The -inherit option determines whether the returned handle will be inherited by child processes. This is false by default.

The access rights associated with the handle default to generic_read unless the -access option is specified. ACCESSRIGHTS specifies the desired access rights and may be specified as a list of integer access rights flags or symbols as described in Access Rights.

If the option -allowhooks is specified as true, processes running in other accounts on the desktop will be allowed to set hooks in the calling process.

When no longer needed, the returned handle should be closed with a call to to close_desktop_handle.
get_desktop_name HDESK
Returns the name of a desktop. HDESK should be a handle to a desktop.
get_desktop_user_sid HDESK
Returns the SID of the user associated with the desktop. HDESK should be a handle to a desktop.
get_window_station_handle WINDOWSTATION ?-inherit BOOL? ?-access ACCESSRIGHTS?
Returns a handle to the window station identified by WINDOWSTATION.

The access rights associated with the handle default to generic_read unless the -access option is specified. ACCESSRIGHTS specifies the desired access rights and may be specified as a list of integer access rights flags or symbols as described in Access Rights.

The -inherit option determines whether the returned handle will be inherited by child processes. This is false by default.

When no longer needed, the returned handle should be closed with a call to to close_window_station_handle.
get_window_station_name HWINSTA
Returns the name of a window station. HWINSTA should be a handle to a window station.
get_window_station_user_sid HWINSTA
Returns the SID of the user associated with a window station. HWINSTA should be a handle to a window station.
set_process_window_station HWINSTA
Assigns the window station identified by HWINSTA to the calling process. HWINSTA should be a window station handle previously returned by get_window_station_handle. See the description of SetProcessWindowStation in the Windows SDk for more details.

COPYRIGHT

Copyright © 2003-2009 Ashok P. Nadkarni

Tcl Windows API 5.0