SubmitItemUpdate:提交项目更新
将更新句柄中配置的内容及变更发送到 Steam。适用于实现工坊上传和管理工具的开发者。
函数声明
SteamAPICall_t SubmitItemUpdate( UGCUpdateHandle_t handle, const char *pchChangeNote );
参数
| 名称 | 类型 | 作用 |
|---|---|---|
handle |
UGCUpdateHandle_t |
输入:由 StartItemUpdate 取得、用于本次操作的更新句柄。 |
pchChangeNote |
const char * |
输入:本次更新说明字符串;不提供说明时可传 NULL。 |
返回与完成机制
返回 SteamAPICall_t;用 SubmitItemUpdateResult_t 检查 m_eResult 和协议标志。句柄无效时返回 k_uAPICallInvalid。
该返回值标识一次异步调用;注册对应调用结果并持续运行 Steam 回调,不能把取得句柄视为操作成功。结果结构和相关类型见站内 API 类型参考。
调用规则与常见错误
提交前检查所有设置调用的返回值。提交后没有取消该次上传的方法;进度可通过 GetItemUpdateProgress 观察,但最终结果以异步调用结果为准。pchChangeNote 可为空指针。
相关站内接口
StartItemUpdate、GetItemUpdateProgress;回调、结构体及枚举。