SendQueryUGCRequest：发送已配置的查询

ISteamUGC::SendQueryUGCRequest 用于发送已配置的查询。本页面向 Steam 创意工坊浏览器与工具开发者，说明该调用的参数、结果以及它在查询流程中的使用条件。

函数声明

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

SteamAPICall_t SendQueryUGCRequest( UGCQueryHandle_t handle );

参数

返回与完成机制

返回 SteamAPICall_t，它标识一次异步调用，不是查询数据本身。应用需绑定对应调用结果并驱动 Steam 回调；处理完成后再使用结果或处理失败。

调用规则与注意事项

先由三种 CreateQuery 方法之一取得句柄，完成标签、语言、缓存和返回字段选项后再发送。无效句柄返回 k_uAPICallInvalid；注册 SteamUGCQueryCompleted_t 调用结果并持续运行 Steam 回调。成功后读取结果，结束时释放查询句柄。

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

相关站内接口

CreateQueryUGCDetailsRequest、ReleaseQueryUGCRequest；数据结构与枚举可参阅 回调、结构体与枚举。

站内字段参考

SteamUGCQueryCompleted_t。

资料依据：Steamworks ISteamUGC 接口。