Package Ganga :: Package Utility :: Package AMGAServerTools :: Module winprocess :: Class Process
[hide private]
[frames] | no frames]

Class Process

source code

A Windows process.

Instance Methods [hide private]
 
__init__(self, cmd, login=None, hStdin=None, hStdout=None, hStderr=None, show=1, xy=None, xySize=None, desktop=None)
Create a Windows process.
source code
 
wait(self, mSec=None)
Wait for process to finish or for specified number of milliseconds to elapse.
source code
 
kill(self, gracePeriod=5000)
Kill process.
source code
 
__close__(self, hwnd, dummy)
EnumWindows callback - sends WM_CLOSE to any window owned by this process.
source code
 
exitCode(self)
Return process exit code.
source code
Method Details [hide private]

__init__(self, cmd, login=None, hStdin=None, hStdout=None, hStderr=None, show=1, xy=None, xySize=None, desktop=None)
(Constructor)

source code 

        Create a Windows process.
        cmd:     command to run
        login:   run as user 'Domain
User
Password'
        hStdin, hStdout, hStderr:
                 handles for process I/O; default is caller's stdin,
                 stdout & stderr
        show:    wShowWindow (0=SW_HIDE, 1=SW_NORMAL, ...)
        xy:      window offset (x, y) of upper left corner in pixels
        xySize:  window size (width, height) in pixels
        desktop: lpDesktop - name of desktop e.g. 'winsta0\default'
                 None = inherit current desktop
                 '' = create new desktop if necessary

        User calling login requires additional privileges:
          Act as part of the operating system [not needed on Windows XP]
          Increase quotas
          Replace a process level token
        Login string must EITHER be an administrator's account
        (ordinary user can't access current desktop - see Microsoft
        Q165194) OR use desktop='' to run another desktop invisibly
        (may be very slow to startup & finalize).
        

kill(self, gracePeriod=5000)

source code 

Kill process. Try for an orderly shutdown via WM_CLOSE. If still running after gracePeriod (5 sec. default), terminate.