xl_dl_get_task_state

说明:

查询任务状态。

语法:

int32_t xl_dl_get_task_state(uint64_t task_id, xl_dl_task_state* state);

参数:

[in]task_id: 任务 ID。

[out]state: 指向 struct xl_dl_task_state_t 结构体的指针。

struct xl_dl_task_state_t {
  uint64_t speed;           // 任务下载速度，Bytes/s
  uint64_t total_size;      // 文件总字节数
  uint64_t downloaded_size; // 已下载总字节数
  uint8_t  state_code;      // 任务状态码
  uint32_t task_err_code;   // 任务错误码
  uint32_t task_token_err;  // token 错误码
};

返回值:

成功返回 0，失败返回相应错误码。

备注:

任务状态码说明：

XL_DL_TASK_STATUS_UNKOWN         = 0 // 未知
XL_DL_TASK_STATUS_START_WAITING  = 3 // 等待启动
XL_DL_TASK_STATUS_START_PENDING  = 4 // 正在启动
XL_DL_TASK_STATUS_STARTED        = 5 // 正在运行
XL_DL_TASK_STATUS_STOP_PENDING   = 6 // 正在停止
XL_DL_TASK_STATUS_STOPED         = 7 // 已停止
XL_DL_TASK_STATUS_SUCCEEDED      = 8 // 任务已完成
XL_DL_TASK_STATUS_FAILED         = 9 // 任务失败