Core Function ProcessWaitClose - Revision history

UberFoX: 1 revision

2015-06-14T12:38:42Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:37Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* Remarks */

2011-12-07T20:22:51Z

Remarks

← Older revision		Revision as of 20:22, 7 December 2011
Line 26:		Line 26:

	Process names are executables without the full path, e.g., "notepad.exe" or "winword.exe"		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.		PID is the unique number which identifies a Process.

UberFoX: /* Example */

2011-11-29T11:23:27Z

Example

← Older revision		Revision as of 11:23, 29 November 2011
Line 40:		Line 40:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	~~ProcessClose~~("notepad.exe");	+	//waits until no instance of notepad.exe exists
		+	ProcessWaitClose("notepad.exe");
		+
		+	// This will wait until this particular instance of notepad has exited
		+	$PID = Run("notepad.exe");
		+	ProcessWaitClose($PID)

−	~~$PID = ProcessExists("notepad.exe"); // Will return the PID or 0 if the process isn't found.~~
−	~~If ($PID) ProcessClose($PID);~~
	</syntaxhighlight>		</syntaxhighlight>

	[[Category:Core Function]]		[[Category:Core Function]]

UberFoX: Created page with "

 ProcessWaitClose( ,  )

=== Description === Pauses the current thread until a given process no longer exists or optional the timeout expires. ==..."

2011-11-29T11:23:12Z

Created page with "<pre> ProcessWaitClose( <pid/name>, <timeout> ) </pre> === Description === Pauses the current thread until a given process no longer exists or optional the timeout expires. ==..."

New page

<pre>
ProcessWaitClose( <pid/name>, <timeout> )
</pre>

=== Description ===

Pauses the current thread until a given process no longer exists or optional the timeout expires.

=== Parameters ===

==== pid/name ====

The name or PID of the process to check.

==== timeout ====

Optional; Specifies how long to wait (default is to wait indefinitely).

=== Return Value ===

Success: Returns 1.

Failure: Returns 0 if wait timed out.

=== 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 ===

<syntaxhighlight lang="sputnik">
ProcessClose("notepad.exe");

$PID = ProcessExists("notepad.exe"); // Will return the PID or 0 if the process isn't found.
If ($PID) ProcessClose($PID);
</syntaxhighlight>

[[Category:Core Function]]