CreateQueryUGCDetailsRequest:按项目 ID 创建详情查询
ISteamUGC::CreateQueryUGCDetailsRequest 用于按项目 ID 创建详情查询。本页面向 Steam 创意工坊浏览器与工具开发者,说明该调用的参数、结果以及它在查询流程中的使用条件。
函数声明
以下声明记录了当前参考页面的接口形式;不同 SDK 版本应以项目实际使用的头文件为准。通过初始化成功后的 SteamUGC() 访问该接口。
UGCQueryHandle_t CreateQueryUGCDetailsRequest( PublishedFileId_t *pvecPublishedFileID, uint32 unNumPublishedFileIDs );
参数
| 参数 | 类型 | 说明 |
|---|---|---|
pvecPublishedFileID |
PublishedFileId_t * |
输入:需要查询详情的工坊项目 ID 数组。 |
unNumPublishedFileIDs |
uint32 |
输入:ID 数组的元素个数。 |
返回与完成机制
成功时返回查询句柄,创建失败返回 k_UGCQueryHandleInvalid。句柄只是请求的本地标识;发送后还需等待异步查询完成,最后调用释放接口。
调用规则与注意事项
传入一个或多个已发布项目 ID,适合为当前界面提供详情。文档列出的单次上限为 1000 项,数量小于 1 会返回无效句柄;不必为只显示少量条目的界面一次请求全部 ID。
创建只准备查询,尚未发出网络请求。可按需要设置筛选和返回字段,随后调用 SendQueryUGCRequest;完成读取或处理失败后释放句柄。
相关站内接口
CreateQueryAllUGCRequest、SendQueryUGCRequest;数据结构与枚举可参阅 回调、结构体与枚举。
资料依据:Steamworks ISteamUGC 接口。