ReleaseQueryUGCRequest:释放查询句柄
ISteamUGC::ReleaseQueryUGCRequest 用于释放查询句柄。本页面向 Steam 创意工坊浏览器与工具开发者,说明该调用的参数、结果以及它在查询流程中的使用条件。
函数声明
以下声明记录了当前参考页面的接口形式;不同 SDK 版本应以项目实际使用的头文件为准。通过初始化成功后的 SteamUGC() 访问该接口。
bool ReleaseQueryUGCRequest( UGCQueryHandle_t handle );
参数
| 参数 | 类型 | 说明 |
|---|---|---|
handle |
UGCQueryHandle_t |
输入:查询句柄,由创建查询的方法取得。 |
返回与完成机制
声明返回 bool,官方说明此方法始终返回 true。它只释放资源,不能用来判断查询是否成功。
调用规则与注意事项
此操作释放查询及结果占用的资源。创建后无论处理成功还是失败,都要设计清理路径;读取结果和复制应用所需数据之后再释放。文档对该函数的返回说明为始终返回 true,不能把它当成查询成功的证据。
查询采用创建、配置、发送、接收结果、读取、释放的生命周期。异步处理期间保持相关对象有效,并定期调用 Steam 回调调度;不要在释放句柄后继续读取它的结果。
相关站内接口
SendQueryUGCRequest、GetQueryUGCResult;数据结构与枚举可参阅 回调、结构体与枚举。
资料依据:Steamworks ISteamUGC 接口。