/admin/win/nsi/nsis_processes/src/processes.txt

  1----------------------------------------------------------------
  2----------------------------------------------------------------
  3Processes (Processes.dll)
  4Version:	1.0.0.1
  5Release:	12.december.2004
  6Description:Nullsoft Installer (NSIS) plug-in for managing?! 
  7			Windows processes.
  8
  9Copyright:	Š 2004 Hardwired. No rights reserved.
 10			There is no restriction and no guaranty for using
 11			this software.
 12
 13Author:		Andrei Ciubotaru [Hardwired]
 14			Lead Developer ICode&Ideas SRL (http://www.icode.ro)
 15			hardwiredteks@gmail.com, hardwired@icode.ro
 16
 17----------------------------------------------------------------
 18----------------------------------------------------------------
 19INTRODUCTION
 20
 21	The Need For Plug-in - I need it for the one of my installers.
 22	
 23	Briefly: Use it when you need to find\kill a process when
 24installing\uninstalling some application. Also, use it when you 
 25need to test the presence of a device driver.
 26
 27
 28SUPPORT
 29	
 30	Supported platforms are: WinNT,Win2K,WinXP and Win2003 Server.
 31
 32
 33DESCRIPTION
 34
 35	Processes::FindProcess <process_name.exe>
 36	
 37		Searches the currently running processes for the given
 38		process name.
 39		
 40		return:	1	- the process was found
 41				0	- the process was not found
 42	
 43	Processes::KillProcess <process_name.exe>
 44	
 45		Searches the currently running processes for the given
 46		process name. If the process is found then the it gets
 47		killed.
 48		
 49		return:	1	- the process was found and killed
 50				0	- the process was not found or the process
 51						cannot be killed (insuficient rights)
 52	
 53	Processes::FindDevice <device_base_name>
 54	
 55		Searches the installed devices drivers for the given
 56		device base name.
 57		(important: I said BASE NAME not FILENAME)
 58		
 59		return:	1	- the device driver was found
 60				0	- the device driver was not found
 61				
 62
 63USAGE
 64
 65	First of all, does not matter where you use it. Ofcourse, the
 66routines must be called inside of a Section/Function scope.
 67
 68	Processes::FindProcess "process_name.exe"
 69	Pop $R0
 70 
 71	StrCmp $R0 "1" make_my_day noooooo
 72	
 73	make_my_day:
 74		...
 75	
 76	noooooo:
 77		...
 78		
 79	
 80	Processes::KillProcess "process_name.exe"
 81	Pop $R0
 82 
 83	StrCmp $R0 "1" dead_meat why_wont_you_die
 84	
 85	dead_meat:
 86		...
 87	
 88	why_wont_you_die:
 89		...
 90		
 91
 92	Processes::FindDevice "device_base_name"
 93	Pop $R0
 94 
 95	StrCmp $R0 "1" blabla more_blabla
 96	
 97	blabla:
 98		...
 99	
100	more_blabla:
101		...
102		
103	
104THANKS
105
106	Sunil Kamath for inspiring me. I wanted to use its FindProcDLL
107but my requirements made it imposible.
108
109	Nullsoft for creating this very powerfull installer. One big,
110free and full-featured (hmmm... and guiless for the moment) mean
111install machine!:)
112
113	ME for being such a great coder...
114											... HAHAHAHAHAHAHA!
115											
116ONE MORE THING
117
118	If you use the plugin or it's source-code, I would apreciate
119if my name is mentioned.
120
121----------------------------------------------------------------
122----------------------------------------------------------------