HixlCSClientQueryCompleteStatus
函数功能
查询异步批量任务的完成状态。
函数原型
HixlStatus HixlCSClientQueryCompleteStatus(HixlClientHandle client_handle,
CompleteHandle complete_handle,
HixlCompleteStatus *complete_status);
参数说明
参数名 |
输入/输出 |
描述 |
|---|---|---|
client_handle |
输入 |
客户端句柄。 |
complete_handle |
输入 |
需要查询的任务句柄。 |
complete_status |
输出 |
返回任务状态枚举,详见HixlCompleteStatus。 |
返回值
- HIXL_SUCCESS:查询成功,传输状态需要根据complete_status确定。
- HIXL_PARAM_INVALID:参数错误
- 其他:失败
约束说明
- 最大支持4K个数据并发传输,下发任务后需及时调用HixlCSClientQueryCompleteStatus接口查询任务状态。
- 查询传输任务状态为HIXL_COMPLETE_STATUS_COMPLETED时,相关资源将自动释放,不支持使用相同的complete_handle再次查询。
- 查询传输任务状态为HIXL_COMPLETE_STATUS_WAITING时,需用户自行判断当前传输任务是否已经发生超时,如果超时可重建传输链路进行重试,并销毁当前异常链路。
父主题: 接口说明