xl_dl_set_http_header

说明:

该接口用于为下载请求设置 HTTP 头部信息。 当下载服务器要求请求中包含特定的 HTTP 头部字段（如 Referer）时，开发者可调用此接口为指定的下载任务设置相应的 HTTP 头部键值对。

语法:

int32_t xl_dl_set_http_header(uint64_t task_id, const char* header_name, const char* header_value);

示例:

// 创建任务
uint64_t task_id = 0;
code = xl_dl_create_p2sp_task(&create_info, &task_id);

// 请务必在 xl_dl_start_task 前设置 http header
code = xl_dl_set_http_header(task_id, "Referer", "http://www.xunlei.com/");

// 开始任务
code = xl_dl_start_task(task_id);

参数:

[in] task_id: 指定需要设置 HTTP 头部信息的下载任务 ID。

[in] header_name: 要设置的 HTTP 头部字段的键名，例如 Referer、User-Agent 等。

[in] header_value: 对应 HTTP 头部字段键名的值，即该头部字段的具体内容。（header_value 务必遵循 HTTP 的相应规范要求，例如当 header_name 为 Referer 时，其所对应的值应为合法合规的 URI（统一资源标识符），以此确保所设头部信息的有效性）

返回值:

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