DLLTaskStop

函数 DLLTaskStop 停止一个或多个程序任务。（通过任务掩码指定要停止的任务，支持同时停止多个任务。）

所属：C/C++ API 函数索引

C/C++

ErrorCode DLLTaskStop(INT_PTR hClientHandle, unsigned int taskMask, unsigned int timeoutMs);

C#

Controller.Tasks.StopPrograms(...) — 停止任务程序（支持 TaskMask/TaskId[] 重载）。

参数

hClientHandle (INT_PTR)

客户端会话句柄，由 DLLSysConnect 获取。

taskMask (unsigned int)

任务掩码。第 n 位（0-indexed）对应任务 n+1。如停止任务 1 和 3：taskMask = (1<<0) | (1<<2) = 0x5。停止所有任务可传入 0xFFFFFFFF。

timeoutMs (unsigned int)

停止超时时间，单位毫秒。等待任务正常停止的最大时间。超时后任务被强制终止。

返回值

返回 ErrorCode；NoError (0) 表示成功，CannotAbortCallingTask 表示尝试停止调用者自身任务，详见 SDK 发布头 ErrorCode.h。

示例

DLLTaskStop(handle, 0x1, 5000);   /* 停止任务 1，5 s 超时 */

相关函数

• DLLOneScriptStop
• DLLOneScriptLoad