HixlCSClientBatchGetSync
函数功能
同步批量从Server读取多组数据到本地：在整批传输完成、超时或失败前，会阻塞当前线程，不返回 CompleteHandle。
函数原型
HixlStatus HixlCSClientBatchGetSync(HixlClientHandle client_handle,
uint32_t list_num,
const HixlOneSideOpDesc *desc_list,
uint32_t timeout_ms);
参数说明
参数名 |
输入/输出 |
描述 |
|---|---|---|
client_handle |
输入 |
客户端句柄，不可为 NULL。 |
list_num |
输入 |
子任务个数，须大于0；取值为0时返回HIXL_PARAM_INVALID。 |
desc_list |
输入 |
长度为list_num的HixlOneSideOpDesc数组；list_num > 0 时desc_list不可为 NULL。数据方向为 local_buf（源）→ remote_buf（目标）。 |
timeout_ms |
输入 |
整批任务的总等待超时时间，单位：毫秒。超时则返回HIXL_TIMEOUT。 |
返回值
- HIXL_SUCCESS：整批数据传输已完成
- HIXL_PARAM_INVALID：参数错误（如：list_num == 0、desc_list非法、client_handle为NULL等）
- HIXL_TIMEOUT：在timeout_ms内未完成整批数据传输
- 其他：传输或内部错误（详见日志和HixlStatus码）
约束说明
- 调用前须已完成与Server的建链，且desc_list中的地址须为已注册。
- 单个链路不支持并发。
父主题： 接口说明