Version History

Tcl Windows API extension version history

DESCRIPTION

Summarizes the list of changes for each version of TWAPI.

Version 2.1

• Built desktop and server specific TWAPI packages containing a subset of the TWAPI commands with a smaller footprint. Reduced footprint of full TWAPI package as well.
• Added recycle_file.
• Added error notifications to begin_filesystem_monitor.
• Added options -foundcodepage, -foundlangid and -datetime to get_file_version_resource.
• Added Wow64EnableWow64FsRedirection, Wow64DisableWow64FsRedirection, and Wow64RevertWow64FsRedirection.
• Added new formats to get_current_user.
• Added SHChangeNotify, CryptAcquireContext, CryptReleaseContext, and CryptGenRandom. No Tcl wrappers for these.

Version 2.0

• INCOMPATIBLE CHANGE Windows NT 4.0 is no longer a supported platform.
• Added support for distribution as a single file Tcl module for Tcl 8.5.
• Added support for Tcl-based Windows services.
• Added Microsoft Windows Installer interface support.
• Added SSPI support (experimental).
• Added Power Management module.
• Added start_device_change_monitor and stop_device_change_monitor.
• Added start_clipboard_monitor and stop_clipboard_monitor.
• Added -patterns option to begin_filesystem_monitor.
• Added get_priority_class, set_priority_class, get_thread_relative_priority and set_thread_relative_priority.
• Added commands get_outgoing_interface, get_route and get_routing_table.
• Added commands get_display_devices, get_display_monitors, get_display_monitor_from_window, get_display_monitor_from_point, get_display_monitor_from_rect, get_display_monitor_info.
• Added commands find_physical_disks and get_physical_disk_info.
• Added create_file.
• Added device_ioctl.
• Added -extents option to get_volume_info.
• Added -isnull subcommand to COM objects.
• Added get_input_idle_time.
• Added large_system_time_to_timelist and timelist_to_large_system_time.
• Added -modulename, -modulepath, -bindtime options to get_tcp_connections and get_udp_connections. Modified -matchremoteaddr and -matchlocaladdr options to allow DNS names and accept multiple addresses.
• Added -messageonlywindow option to find_windows.
• Added options -noexist and -noaccess to get_thread_info. INCOMPATIBLE CHANGE The command no longer raises an exception if a thread does not exist or cannot be accessed.
• Additional performance optimizations.

Version 1.1

• Added enhanced Windows task scheduler interface.
• Added commands find_lm_sessions, end_lm_sessions, get_lm_session_info and find_lm_connections dealing with Lan Manager sessions and connections.
• Added commands find_lm_open_files, close_lm_open_file and get_lm_open_file_info dealing with files opened in Lan Manager sessions.
• Added find_domain_controller command.
• Added get_file_times and set_file_times dealing with file timestamps.
• Enhanced get_process_info and get_thread_info return additional process and thread information.
• Enhanced get_processor_info to return additional processor information.
• Enhanced get_memory_info to return additional swap file information.
• Replaced Windows performance counter calls with native Win32 calls resulting in almost two orders of magnitude better performance in retrieving process, thread and system information.
• Added get_system_time.
• Added secs_since_1970_to_large_system_time.
• Added variant_time_to_timelist and timelist_to_variant_time.
• Added -handle option to get_resource_security_descriptor and options -handle, -unprotect_dacl and -unprotect_sacl to set_resource_security_descriptor.
• Added -logonsession option to get_process_ids.
• Include process id and attribute information (if available) in data returned by get_service_status and get_multiple_service_status.
• INCOMPATIBLE CHANGE Changed default value of new_share option -secd.
• Bug fixes.

Version 1.0

• Added read_inifile_section and read_inifile_section_names.
• INCOMPATIBLE CHANGE Removed unsupported commands get_open_handles and get_open_handle_pids. They used undocumented system functions and caused some nasty behaviour with the latest service packs.
• Added option -stdchannels to create_process.

Version 1.0 Beta

• INCOMPATIBLE CHANGE The error class stored in errorCode when Windows encounters an error has changed. In V0.9 and before, the error class was WINDOWS. To prevent clashes with other extensions, the error class now used is TWAPI_WIN32. Code that traps errors using pattern matching in try or otherwise parses errorCode will need to be modified accordingly.
• Added COM module.
• Added get_system_parameters_info and set_system_parameters_info.
• Added get_file_version_resource.
• Added map_langid_to_name.

Version 0.9

Note: only bug fixes that are incompatible with previous releases are mentioned here.

• INCOMPATIBLE CHANGE Remote file shares now have type file instead of disk for consistency with local file shares.
• Added write_shortcut and read_shortcut.
• Added write_url_shortcut, read_url_shortcut and invoke_url_shortcut.
• Added get_primary_domain_info.
• Added commands address_to_hostname, hostname_to_address, port_to_service and service_to_port.
• Added command get_system_info.
• Added get_computer_name.
• Added -logonsession option to get_process_info.
• Added Windows 2000 support for shell_object_properties_dialog, volume_properties_dialog, file_properties_dialog, printer_properties_dialog.
• Added -user option to get_process_ids.
• Added get_user_local_groups_recursive.
• Added command get_security_descriptor_control.
• Added commands get_ace_text and get_security_descriptor_text.

Version 0.8

• INCOMPATIBLE CHANGE Changed to require at least Service Pack 4 on Windows NT 4.0. The extension will no longer load on otherwise. This was required to support the LSA related functions.
• Added commands find_logon_sessions and get_logon_session_info for dealing with logon sessions.
• Added commands to retrieve information related to Windows shell Themes.
• Added commands get_global_group_info and get_local_group_info.
• Added commands get_tcp_connections and get_udp_connections and terminate_tcp_connections.
• Added LSA related commands add_account_rights, remove_account_rights, find_accounts_with_right, get_accounts_with_rights,
• Modified commands delete_user, delete_global_group and delete_local_group to remove account rights before deleting the account.
• Added enumerate_printers.
• Added shell_object_properties_dialog, volume_properties_dialog, file_properties_dialog, printer_properties_dialog.
• Added get_system_uptime.
• Added large_system_time_to_secs.
• Added configure_window_titlebar.
• Added get_client_share_info. get_mapped_share_info is now deprecated.
• Added suspend_system.
• Added get_privilege_description,
• Added option -description to get_service_configuration.
• Added options -noaccess and -noexist to commands get_process_info, get_process_parent and get_process_commandline. INCOMPATIBLE CHANGE These commands no longer raise a Tcl error if the process does not exist or if access is denied to the process.
• Added command map_code_page_to_name
• Added option -sid to get_user_account_info.
• Added commands is_system_pid and is_idle_pid.
• Added commands extract_primary_langid and extract_sublanguage_langid.
• Significant improvement in retrieval of performance related data.
• INCOMPATIBLE CHANGE The format of return value of the get_token_privileges command has changed when the -all option is specified. The value returned by the -privileges option of the get_process_info has changed accordingly.
• INCOMPATIBLE CHANGE get_drive_type now returns invalid as the drive type for non-existent drives instead of generating an error.

Version 0.7

• Added high level Tcl interface for console access to replace direct Win32 API calls.
• Added volume and mount point related commands (see disk.html)
• INCOMPATIBLE CHANGE Enhanced begin_filesystem_monitor to return more detail.
• Enhanced get_service_status to return the process id of the service.
• For consistency, renamed get_drive_info to get_volume_info and get_logical_drives to find_logical_drives. Older names will still work.
• Miscellaneous bug fixes.

Version 0.6

• Added commands begin_filesystem_monitor and end_filesystem_monitor for monitoring file system changes.
• Added module Desktops and Window Stations.
• Added module Internationalization.
• Added command get_shell_folder.
• Added command get_desktop_workarea.
• Added commands get_desktop_wallpaper and set_desktop_wallpaper.

Version 0.5

• Removed dependencies on the external cmdline and TclExcept packages. These are no longer required.
• Added the Task Scheduler module
• Added duplicate_handle
• Added get_primary_domain_controller
• Added options -groups, -primarygroup, -user and -privileges to commands get_process_info and get_thread_info
• Added parseargs for option parsing
• Added get_process_parent
• Added get_process_commandline and option -commandline to get_process_info
• Added command get_process_exit_code
• Added command get_display_size
• Added commands get_command_line and get_command_line_args
• Added try command
• Added get_version to get TWAPI version information
• Added eval_with_privileges, enable_privileges and disable_privileges
• Added -sync option to move_window and resize_window commands.
• INCOMPATIBLE CHANGE Return values from enable_token_privileges, disable_token_privileges and disable_all_token_privileges have changed.
• INCOMPATIBLE CHANGE Command arguments for open_process_token and open_thread_token have changed.
• INCOMPATIBLE CHANGE stop_sound usage has changed.
• INCOMPATIBLE CHANGE Usage and semantics of the -toplevel option for find_windows has changed.
• INCOMPATIBLE CHANGE Removed -dpcbypassrate and -apcbypassrate options from command get_processor_info as they are not present on XP and Windows 2003.
• Greatly expanded test coverage.

Version 0.4

• Added support to be sourced as a single file Starkit
• Added the Network configuration module
• Added the Clipboard module
• Added get_memory_info to retrieve system physical and virtual memory information
• Added get_open_handle_pids to retrieve a list of processes that have an open handle to a resource.
• Added option -handles to get_process_info to retrieve a list of open handles in a process.
• Added get_open_handles to retrieve information about open handles in the system.
• Added -device option to get_drive_info command
• INCOMPATIBLE CHANGE Changed set_drive_volumename to set_drive_label and changed option -volumename of get_drive_info to -label. This is to avoid future confusion with logical volumes as defined by Windows.
• Added options -processormodel, -processorname and -processorspeed to get_processor_info.
• INCOMPATIBLE CHANGE Changed the arguments to commands get_process_handle and get_thread_handle.
• INCOMPATIBLE CHANGE Changed get_os_info to not return memory related information. get_memory_info provides a superset of the same information.
• Documentation is now in Windows compiled help format with index and search.

Version 0.3

• Added the Event log module
• Added the Console module
• Added register_hotkey and unregister_hotkey
• Added create_process, get_process_handle and get_thread_handle
• Added suspend_thread and resume_thread
• Added shutdown_system and abort_system_shutdown
• Added format_message and map_windows_error
• Added logoff_user and lock_workstation
• Added get_current_user
• Added expand_environment_strings
• Added load_library and free_library
• Added get_processor_count and get_active_processor_mask
• Enhanced get_os_info to return additional OS information
• Enhanced get_processor_info to return additional processor information
• Added commands read_inifile_key, write_inifile_key, delete_inifile_key and delete_inifile_section for manipulating INI files.
• Added process_waiting_for_input
• Added block_input
• Added close_handles
• Added get_tcl_channel_handle
• Bug fixes to delete_share, close_window

Version 0.2

• Added the Security module containing commands for user/group management, resource protection, access control, authorization and impersonation
• Added the Network shares module containing commands for configuration of network shares
• Added play_sound for basic audio playback
• Added send_keys command (clone of Visual Basic SendKeys using same syntax) for generating keystrokes
• Added find_windows
• Added get_logical_drives
• Added get_drive_type
• Added set_drive_volumename
• Added get_mouse_location
• Added get_computer_netbios_name
• INCOMPATIBLE CHANGE Changed parameters and return format for get_process_modules.
• INCOMPATIBLE CHANGE Changed the -machine and -display_name options in the services module to -system and -displayname for consistency with other modules.
• INCOMPATIBLE CHANGE Several commands that used to return multiple values in fieldname value format have been changed so that the fieldname matches the option specified to retrieve the field (to include the - prefix). These commands include get_device_drivers, get_process_info, get_disk_info, get_user_account_info, lookup_account_name
• INCOMPATIBLE CHANGE get_service_configuration options and return format has changed.
• INCOMPATIBLE CHANGE The return values from the commands start_service, stop_service, pause_service, resume_service and interrogate_service have changed. Moreover, start_service and stop_service will no longer throw an exception if the service is already running or stopped respectively.
• Allow window styles to be expressed as symbols in addition to bitmasks
• The commands start_service, stop_service, pause_service, resume_service now take an additional -wait option.

Version 0.1

• Initial release

COPYRIGHT

Copyright © 2003-2008 Ashok P. Nadkarni