Core Function ProcessExists
From Sputnik Wiki
(Difference between revisions)
(Created page with "<pre> ProcessExists( <pid/name> ) </pre> === Description === Checks to see if a specified process exists. === Parameters === ==== pid/name ==== The name or PID of the proce...") |
(→Example) |
||
| Line 36: | Line 36: | ||
<syntaxhighlight lang="sputnik"> | <syntaxhighlight lang="sputnik"> | ||
| − | If (ProcessExists("notepad.exe")) | + | If ($PID = ProcessExists("notepad.exe")) |
{ | { | ||
| − | MsgBox("Notepad is running | + | MsgBox("Notepad is running and its PID is '$PID'"); |
} | } | ||
else | else | ||
| Line 44: | Line 44: | ||
MsgBox("Notepad not is running."); | MsgBox("Notepad not is running."); | ||
} | } | ||
| − | |||
| − | |||
</syntaxhighlight> | </syntaxhighlight> | ||
[[Category:Core Function]] | [[Category:Core Function]] | ||
Revision as of 20:12, 7 December 2011
ProcessExists( <pid/name> )
Contents |
Description
Checks to see if a specified process exists.
Parameters
pid/name
The name or PID of the process to check.
Return Value
Success: Returns the PID of the process.
Failure: Returns 0 if process does not exist.
Remarks
Process names are executables without the full path, e.g., "notepad.exe" or "winword.exe"
If multiple processes have the same name, the one with the highest PID is terminated--regardless of how recently the process was spawned.
PID is the unique number which identifies a Process.
A PID can be obtained through the ProcessExists or Run commands.
In order to work under Windows NT 4.0, ProcessClose requires the file PSAPI.DLL.
The process is polled approximately every 250 milliseconds.
Example
If ($PID = ProcessExists("notepad.exe")) { MsgBox("Notepad is running and its PID is '$PID'"); } else { MsgBox("Notepad not is running."); }
