xl_dl_create_batch_task

说明:

创建批量 P2SP 下载任务。

语法:

int32_t xl_dl_create_batch_task(const xl_dl_create_batch_info* create_info, uint64_t* task_id);

参数:

[in] create_info: 指向 xl_dl_create_batch_info 结构体的指针，包含批量任务配置信息。

struct xl_dl_create_batch_info_t {
  const char*     task_name;      // 任务名称, utf8 编码
  uint32_t        max_concurrent; // 最大并发下载数，默认值为 20
  xl_dl_files_info* batch_files;  // 批量文件信息
};

struct xl_dl_files_info_t {
  uint32_t         file_count; // 文件数量 (需确保 file_list 数组大小与 file_count 一致)
  xl_dl_file_item* file_list;  // 文件列表（数组）
};

struct xl_dl_file_item_t {
  const char* url;       // 下载 URL（必填）
  const char* save_path; // 文件存储路径（必填）
  const char* save_name; // 文件名（必填）
  const char* file_hash; // 文件哈希值（可选，目前留作扩展用途）
};

[in, out]task_id: 任务创建成功后任务 ID 被设置到该指针指向的变量中。

返回值:

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