# process.suspend

## 功能

Windows 下暂停已启动子进程及其子进程树。适合 bt_app 桌面批处理任务临时暂停 PowerShell、WPS、poppler 等多级子进程。

## 语法

```bt
process(program).child().suspend()
```

## 参数

无参数。

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Bool | 成功暂停至少一个线程返回 true；没有子进程句柄、进程已经退出或没有可暂停线程返回 false。 |

## 示例

```bt
cmd = process('cmd').args(['/C', 'ping 127.0.0.1 -n 5']).child()
result = cmd.suspend()

// 输出：true
print result

cmd.resume()
cmd.kill()
```

## 注意事项

- suspend 不会清空当前保存的子进程句柄。
- Windows 下 suspend 会通过系统进程和线程快照暂停子进程树内可访问线程。
- 暂停后通常需要调用 resume 恢复，或调用 kill 取消任务。
- Linux/macOS 暂不支持该方法，会返回运行时错误。