跳转至

DLLGetLastCommandDetail

函数 DLLGetLastCommandDetail 获取最近一次 DLLExecute 调用失败时的详细错误描述文本。(进程全局,无句柄依赖。)

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

C/C++

ErrorCode DLLGetLastCommandDetail(char* outBuffer, int32_t bufferSize);

C#

C# 无独立等效项;Controller.Commands[taskId].Execute(string) 失败时抛出的异常信息已包含失败详情。

参数

outBuffer (char*)

输出。接收最近失败命令的详细描述字符串。

bufferSize (int32_t)

*outBuffer 缓冲区容量(字符数)。

返回值

返回 ErrorCodeNoError (0) 表示成功,正值为错误码,详见 SDK 发布头 ErrorCode.h。

说明

此函数为进程全局调用,不与任何客户端句柄关联。成功执行(未出错)的命令会将详细文本清空,因此仅在命令失败后调用才有意义。错误详情由 RootCommands.Execute 的实现填充。

示例

if (DLLExecute(handle, 1, "ENABLE X") != NoError) {
    char detail[256] = {0};
    DLLGetLastCommandDetail(detail, sizeof(detail));
    printf("Reason: %s\n", detail);
}

相关函数