Функция ProcessWaitClose

         Описание функции


ProcessWaitClose

Приостанавливает выполнение скрипта до тех пор, пока указанный процесс не перестанет существовать.

ProcessWaitClose ( "process" [, timeout = 0 ] )

Параметры

process Имя или PID процесса.
timeout [необязательный] Время ожидания процесса (в секундах). По умолчанию скрипт ждёт бесконечно долго.

Возвращаемое значение

Успех:Возвращает 1 и устанавливает значение @extended равным коду выхода процесса.
Ошибка:Возвращает 0, если время ожидания истекло. Если указан некорректный PID, значение @error устанавливается не равным нулю, а значение @extended устанавливается равным 0xCCCCCCCC.

Примечания

В качестве имени процесса указывается имя исполняемого файла без указания пути, например, "notepad.exe" или "winword.exe"
PID является уникальным числом, идентифицирующим процесс. PID может быть получен с помощью функций ProcessExists() или Run().
Процесс опрашивается приблизительно каждые 250 миллисекунд.

Функция возвращает 1, если процесс не существует.

См. также

ProcessClose, ProcessExists, ProcessWait, RunWait, WinWaitClose, ProcessList, RunAsWait, WinGetProcess

Пример

; Ожидает момента, когда процесс notepad.exe перестанет существовать
ProcessWaitClose("notepad.exe")

; Ожидает момента, когда конкретный экземпляр блокнота не завершится
$iPID = Run("notepad.exe")
ProcessWaitClose($iPID)