ReleaseQueryUGCRequest:释放查询句柄

ReleaseQueryUGCRequest:释放查询句柄

ISteamUGC::ReleaseQueryUGCRequest 用于释放查询句柄。本页面向 Steam 创意工坊浏览器与工具开发者,说明该调用的参数、结果以及它在查询流程中的使用条件。

工坊分发与加载流程

函数声明

以下声明记录了当前参考页面的接口形式;不同 SDK 版本应以项目实际使用的头文件为准。通过初始化成功后的 SteamUGC() 访问该接口。

bool ReleaseQueryUGCRequest( UGCQueryHandle_t handle );

参数

参数 类型 说明
handle UGCQueryHandle_t 输入:查询句柄,由创建查询的方法取得。

返回与完成机制

声明返回 bool,官方说明此方法始终返回 true。它只释放资源,不能用来判断查询是否成功。

调用规则与注意事项

此操作释放查询及结果占用的资源。创建后无论处理成功还是失败,都要设计清理路径;读取结果和复制应用所需数据之后再释放。文档对该函数的返回说明为始终返回 true,不能把它当成查询成功的证据。

查询采用创建、配置、发送、接收结果、读取、释放的生命周期。异步处理期间保持相关对象有效,并定期调用 Steam 回调调度;不要在释放句柄后继续读取它的结果。

相关站内接口

SendQueryUGCRequest、GetQueryUGCResult;数据结构与枚举可参阅 回调、结构体与枚举。

资料依据:Steamworks ISteamUGC 接口。