GetItemUpdateProgress:读取项目更新进度

GetItemUpdateProgress:读取项目更新进度

查询一次项目更新所处阶段和已处理字节数。适用于实现工坊上传和管理工具的开发者。

工坊发布与加载流程

函数声明

EItemUpdateStatus GetItemUpdateProgress( UGCUpdateHandle_t handle, uint64 *punBytesProcessed, uint64*punBytesTotal );

参数

名称 类型 作用
handle UGCUpdateHandle_t 输入:由 StartItemUpdate 取得、用于本次操作的更新句柄。
punBytesProcessed uint64 * 输出:写入当前已处理的字节数的 uint64 指针。
punBytesTotal uint64* 输出:写入当前更新所需总字节数的 uint64 指针。

返回与完成机制

返回 EItemUpdateStatus;通过两个输出指针获取已处理字节和总字节。状态为 Invalid 可能是句柄无效,也可能操作已完成。

调用规则与常见错误

总字节数可随阶段改变,进度读数不能代替 SubmitItemUpdateResult_t 的最终结果。调用前确保输出变量有效。

相关站内接口

SubmitItemUpdate;回调、结构体及枚举。

站内字段参考

SubmitItemUpdateResult_t。

官方核对:ISteamUGC::GetItemUpdateProgress。