Commands for managing operating system handles
package require twapi
This module provides commands that deal with operating system handles.
Several Win32 and TWAPI commands return operating system handles to various types of resources. The following commands allow manipulation and retrieval of information regarding handles.
The operating system associated with a Tcl channel can be retrieved using the get_tcl_channel_handle command.
The command duplicate_handle can be used to duplicate a handle, for example to pass down to a child process with different access rights.
The command close_handle closes a operating system handle and frees resources associated with it.
|-access ACCESSRIGHTS||Specifies the access rights desired for the new handle. If unspecified, the new handle is created with the same access rights as the original one. ACCESSRIGHTS is a list of symbolic constants and bit masks as specified in Access Rights.|
|-closesource||If specified, HANDLE is closed after it is duplicated.|
|-inherit||If specified, the new handle marked as inheritable. By default, the duplicated handle cannot be inherited by child processes.|
|-sourcepid SOURCEPID||Specifies the PID of the process in whose context HANDLE is a valid handle. Defaults to the current process.|
|-targetpid TARGETPID||Specifies the PID of the process in whose context the new handle is to be created. Specifying this also impacts the format of the returned handle value.|
Copyright © 2004-2005 Ashok P. Nadkarni