跳到主要内容

qk.Process:进程

启动程序、用关联程序打开文件/网址、运行命令行并读取输出、列出与结束进程;在已打开的程序内部执行代码见 qk.Apps。以普通(非提升)权限启动。Run 被停止或 timeoutMs 到期时停止等待并尽力结束进程树。常见错误码:PROCESS_FAILED(启动失败)、PROCESS_TIMEOUT(Run 超时)、LIMIT_EXCEEDED(输出或列表超限)。

Process.Start​

int Start(string executable, string[]? arguments = null, string workingDirectory = "")

以普通权限启动程序并返回 PID;不等待,停止脚本不会结束它。

参数声明说明
string executable见本成员和所在域的说明。
string[]? arguments = null参数数组(逐项传递,无需自行加引号)。
string workingDirectory = ""工作目录;空为默认。

返回类型:int。空值、用户取消和异常行为以成员及域说明为准。

基础能力:启动程序或打开文件/网址。某些参数或数据来源会追加能力,详见安全与授权。

Process.Open​

void Open(string target)

用关联程序打开文件、文件夹或网址。

参数声明说明
string target见本成员和所在域的说明。

返回类型:void。空值、用户取消和异常行为以成员及域说明为准。

基础能力:启动程序或打开文件/网址。某些参数或数据来源会追加能力,详见安全与授权。

Process.Run​

ProcResult Run(string executable, string[]? arguments = null, string workingDirectory = "", string encoding = "utf-8", int timeoutMs = 0)

以普通权限运行命令行程序并等待退出(隐藏窗口);返回退出码与输出,输出每路最多 512K 字符。

参数声明说明
string executable见本成员和所在域的说明。
string[]? arguments = null参数数组(逐项传递,无需自行加引号)。
string workingDirectory = ""见本成员和所在域的说明。
string encoding = "utf-8"输出编码,默认严格 UTF-8(如 gbk)。
int timeoutMs = 0单次超时毫秒(默认 0 为只受动作超时约束);超时报 PROCESS_TIMEOUT(已读输出不返回;尽力结束进程树)。

返回类型:ProcResult。空值、用户取消和异常行为以成员及域说明为准。

基础能力:启动程序或打开文件/网址。某些参数或数据来源会追加能力,详见安全与授权。

Process.List​

ProcInfo[] List(string? name = null)

列出当前登录会话的进程(最多 4096 项)。

参数声明说明
string? name = null进程名(可省略 .exe);null 为全部。

返回类型:ProcInfo[]。空值、用户取消和异常行为以成员及域说明为准。

基础能力:读取窗口信息。某些参数或数据来源会追加能力,详见安全与授权。

Process.Kill​

int Kill(int pid)

结束进程(不含子进程),返回结束的进程数(没有在运行为 0,不报错)。Kill(pid) 结束指定进程(只能是当前登录会话中的进程);Kill(name) 结束当前会话中全部同名进程(名称规则同 List)。拒绝其他会话的进程、Quicker 自身及辅助进程、资源管理器与关键系统进程(INVALID_ARGUMENT,一个都不结束);无权限(如管理员进程)报 PROCESS_FAILED(按名称时全部失败才报)。需要“强制结束程序”能力(可能丢失未保存数据)。

参数声明说明
int pid进程 Id(如 Process.List 的 Pid、Process.Start 的返回值)。

返回类型:int。空值、用户取消和异常行为以成员及域说明为准。

基础能力:强制结束程序。某些参数或数据来源会追加能力,详见安全与授权。

int Kill(string name)

结束进程(不含子进程),返回结束的进程数(没有在运行为 0,不报错)。Kill(pid) 结束指定进程(只能是当前登录会话中的进程);Kill(name) 结束当前会话中全部同名进程(名称规则同 List)。拒绝其他会话的进程、Quicker 自身及辅助进程、资源管理器与关键系统进程(INVALID_ARGUMENT,一个都不结束);无权限(如管理员进程)报 PROCESS_FAILED(按名称时全部失败才报)。需要“强制结束程序”能力(可能丢失未保存数据)。

参数声明说明
string name进程名(不含路径,可省略 .exe)。

返回类型:int。空值、用户取消和异常行为以成员及域说明为准。

基础能力:强制结束程序。某些参数或数据来源会追加能力,详见安全与授权。