AddItemKeyValueTag：添加键值标签
为项目更新添加一组可精确筛选的键和值。适用于实现工坊上传和管理工具的开发者。
函数声明
bool AddItemKeyValueTag( UGCUpdateHandle_t handle, const char *pchKey, const char *pchValue );
参数
| 名称 | 类型 | 作用 |
|---|---|---|
handle |
UGCUpdateHandle_t |
输入：由 StartItemUpdate 取得、用于本次操作的更新句柄。 |
pchKey |
const char * |
输入：目标键值标签的键名。 |
pchValue |
const char * |
输入：与键关联的标签值。 |
返回与完成机制
返回 bool；无效句柄、空指针、键或值超长，以及本次更新添加超过 100 项时可返回 false。
调用规则与常见错误
必须在提交前调用。键只允许字母数字和下划线；键和值各不超过 255 字符。同一键可对应多个值，搜索采用精确匹配。
相关站内接口
RemoveItemKeyValueTags、AddRequiredKeyValueTag、GetQueryUGCKeyValueTag、SubmitItemUpdate；回调、结构体及枚举。