获取最后一次错误ID - GetLastError

函数简介

获取插件内部记录的最后一次错误 ID。通常在某个接口调用失败（返回 0 或其他错误状态）后，调用本接口可以获得更详细的错误码，用于诊断问题类型。

接口名称

GetLastError

DLL调用

int GetLastError()

参数定义:

此函数无参数。

示例:

// 示例：截图失败时获取错误ID
long img = GetScreenDataPtr(ola, 0, 0, 800, 600);
if (img == 0) {
    int32_t err = GetLastError();
    printf("截图失败，错误ID: %d\n", err);
}

// 示例：根据错误ID作简单处理
int32_t err = GetLastError();
if (err != 0) {
    // 可以根据错误码进行分类处理
    // 例如：
    // 0                -> SUCCESS
    // 1001(PERMISSION) -> 权限相关错误
    // 1002(INVALID)    -> 参数错误
    // 2001(CAPTURE)    -> 截图相关错误
}

返回值

整型数:

• 0: 成功 / 没有错误（SUCCESS）
• 非0: 错误 ID（参考下方错误码说明）

常见错误码说明

支持的错误码由内部 OLAError 枚举定义，常见值包括但不限于：

• 0 (SUCCESS): 操作成功 / 无错误
• 1001 (PERMISSION_DENIED): 权限不足或未登录，需要先调用登录/授权相关接口
• 1002 (INVALID_ARGUMENT): 传入参数无效，例如空指针、范围错误等
• 2001 (CAPTURE_ERROR): 截图失败
• 2002 (LOAD_IMAGE_ERROR): 加载图片失败
• 2003 (HWND_NOT_VALID): 窗口句柄无效
• 9999 (UNKNOWN_ERROR): 未知错误或未分类错误

注意事项

1. 错误 ID 为 0 表示没有错误或最近一次操作成功。
2. 一般在接口调用失败后立即调用本接口，获取的是“最近一次”错误信息，若中间再次调用了其他接口，错误状态可能被覆盖。
3. 可以配合 GetLastErrorString 使用，获取对应的错误描述字符串，便于日志记录和调试。
4. 错误码定义可能会在版本更新时扩展，实际值以当前版本插件实现为准。