DLLGetLastCommandDetail
函数 DLLGetLastCommandDetail 获取最近一次 DLLExecute 调用失败时的详细错误描述文本。(进程全局,无句柄依赖。)
C/C++
ErrorCode DLLGetLastCommandDetail(char* outBuffer, int32_t bufferSize);
C#
C# 无独立等效项;Controller.Commands[taskId].Execute(string) 失败时抛出的异常信息已包含失败详情。
参数
outBuffer (char*)
输出。接收最近失败命令的详细描述字符串。
bufferSize (int32_t)
*outBuffer 缓冲区容量(字符数)。
返回值
返回 ErrorCode;NoError (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);
}