开发者
资源

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时,需用户自行判断当前传输任务是否已经发生超时,如果超时可重建传输链路进行重试,并销毁当前异常链路。