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


ProcessClose

Завершает процесс с указанным именем.

ProcessClose ( "process" )

Параметры

process Имя или PID процесса для завершения.

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

Успех:Возвращает 1.
Ошибка:Возвращает 0 и устанавливает значение @error равным:
1 = не удалось выполнить функцию WinApi OpenProcess
2 = не удалось выполнить функцию WinApi AdjustTokenPrivileges
3 = не удалось выполнить функцию WinApi TerminateProcess
4 = не удалось проверить существование процесса
Значение @extended устанавливается равным WinAPI GetLastError

Примечания

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

Процесс опрашивается приблизительно каждые 250 миллисекунд.

См. также

ProcessExists, ProcessWait, ProcessWaitClose, Run, WinClose, ProcessList, RunAs, Shutdown, WinKill

Пример

; Запуск блокнота
$iPID = Run('notepad.exe')

; Ожидание 5 секунд до появление окна блокнота
$hWnd = WinWait("[CLASS:Notepad]", "", 5)
If Not $hWnd Then
    MsgBox(4096, 'Сообщение', 'Окно не найдено, завершаем работу скрипта')
    Exit
EndIf

; Ожидание 2 секунды.
Sleep(2000)

; Закрывает процесс блокнота, используя PID возвращаемый функцией Run.
ProcessClose($iPID)