readme.txt

VFP最近技术介绍

Title
-----
Process Tools for VFP v.1.1 (30 March 2004)

Summary
-------
    Source (.PRG) library for killing processes from within VFP, or getting a list 
of running processes. Is written in pure VFP code, dealing with Win32 API calls and 
it does not need any DLL, FLL or other files like other "killers"...
    Works with any (?) Win32 operating system (Now tested with Win98SE, ME, XP PRO 
and VFP 6, 7 and 8).
    Will NOT work on WinNT/2k.


WARNING!!!
----------
    KILLING VITAL SYSTEM PROCESSES COULD CAUSE UNPREDICTABLE RESULTS AND MAY PUT
YOUR COMPUTER IN AN UNSTABLE ENVIRONMENT SO USE IT WITH CAUTION!!!


Description
-----------
    The library is simple to use as SET LIBRARY TO PROCESS_TOOLS then call the functions
you need. There are implemented 4 functions:

    - ProcID("ExeFileName") - returns the process ID of the EXE file name you specify
    Example: ? ProcID("notepad.exe") returns process ID for Notepad or 0 (zero) if
no process "notepad" is found.

    - KillProcID(lnProcID) - it kills the process ID specified as parameter, and
returns a non zero value if it successfully killed the process or zero if not.
    Example: ? KillProcID("1234") will return 0 if process ID "1234" is not found

    - KillProcN("ExeFileName") - will kill the process name given as parameter and
return non zero value if succeeds or a zero value if it fails.
    Example: ? KillProcN("notepad.exe") will return 0 if no Notepad process found.
             is same as KillProcID(ProcID("notepad.exe")) but is too much to type...

    - ProcList("laProcessesArray") - will create an array of processes founded and 
return the number of processes, or zero if it fails. If the array passed as parameter
does not exist, it will be created.
    Example: ? ProcList("laProcesses") will display the number of running processes.

    * Column description of processes array:
    1 - Process identifier
    2 - Number of execution threads started by the process
    3 - Process identifier of the process that created this process (its parent process)
    4 - Base priority of any threads created by this process
    5 - String that specifies the name of the executable file for the process


    For a little "drive-test" DO DEMO.


Credits
-------
    Thanks to Ilya Rabyy for pointed out a major bug in Win9x and ME, and done some 
refining and cosmetics.


Final word
----------
    Killing processes can be dangerous so again use it with caution, at your own risk.
    For any suggestions or comments you can write to:
       me:     Lucian Constantin
       e-mail: lucian_AT_angst_DOT_ro ( but replace _AT_ and _DOT_ accordingly).


Version History
---------------
1.1 - Major bug solved in Win98 and WinME, now will correctly identify the process
          thanks to Ilya Rabyy, because I test it only on XP  - shame on me - ;-(
    - Some parameters checking and some "cosmetics"

1.0 - Initial release (2004-03-29)


v.1.1. (2004-03-30)