跳转至

DLLOneScriptLoad

函数 DLLOneScriptLoad 将 OneScript(基于 Lua 语法)程序文件(.pgm)加载到指定任务中。(路径由运行 OneController 的 PC 解释,不在控制器端解释。)

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

C/C++

ErrorCode DLLOneScriptLoad(INT_PTR hClientHandle, int taskId, const char* scriptPath);

C#

Controller.Tasks[taskId].OneScript.Load(path) — 加载 OneScript 程序文件到指定任务。

参数

hClientHandle (INT_PTR)

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

taskId (int)

目标任务编号(1-indexed)。推荐使用任务 1(任务 0 为库任务,不适合运行程序)。有效范围 1..N。

scriptPath (const char*)

OneScript 程序文件的完整路径或相对路径(相对于调用进程的当前工作目录)。路径由 PC 端解释。

返回值

返回 ErrorCodeNoError (0) 表示成功,ProgramErrorProgramLoadingError 表示文件读取或编译错误,详见 SDK 发布头 ErrorCode.h。

说明

脚本路径由 PC 端解释,因此 scriptPath 可以是相对路径(相对于调用进程的当前工作目录)或绝对路径。加载成功后需调用 DLLOneScriptRun 执行程序。

示例

DLLOneScriptLoad(handle, 1, "C:\\Scripts\\demo.pgm");
DLLOneScriptRun(handle, 1);

相关函数