GetItemUpdateProgress:读取项目更新进度
查询一次项目更新所处阶段和已处理字节数。适用于实现工坊上传和管理工具的开发者。
函数声明
EItemUpdateStatus GetItemUpdateProgress( UGCUpdateHandle_t handle, uint64 *punBytesProcessed, uint64*punBytesTotal );
参数
| 名称 | 类型 | 作用 |
|---|---|---|
handle |
UGCUpdateHandle_t |
输入:由 StartItemUpdate 取得、用于本次操作的更新句柄。 |
punBytesProcessed |
uint64 * |
输出:写入当前已处理的字节数的 uint64 指针。 |
punBytesTotal |
uint64* |
输出:写入当前更新所需总字节数的 uint64 指针。 |
返回与完成机制
返回 EItemUpdateStatus;通过两个输出指针获取已处理字节和总字节。状态为 Invalid 可能是句柄无效,也可能操作已完成。
调用规则与常见错误
总字节数可随阶段改变,进度读数不能代替 SubmitItemUpdateResult_t 的最终结果。调用前确保输出变量有效。