SetSearchText:搜索项目标题或说明

SetSearchText:搜索项目标题或说明

ISteamUGC::SetSearchText 用于搜索项目标题或说明。本页面向 Steam 创意工坊浏览器与工具开发者,说明该调用的参数、结果以及它在查询流程中的使用条件。

工坊分发与加载流程

函数声明

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

bool SetSearchText( UGCQueryHandle_t handle, const char *pSearchText );

参数

参数 类型 说明
handle UGCQueryHandle_t 输入:查询句柄,由创建查询的方法取得。
pSearchText const char * 输入:要在标题或说明中匹配的搜索文本。

返回与完成机制

返回 bool;设置成功为 true,失败为 false。设置成功只说明当前调用被接受,查询是否成功仍须检查异步完成结果。

调用规则与注意事项

输入搜索文字后,在项目标题或描述中查找匹配项。仅全局查询支持,必须在发送前设置;文本指针为空、句柄无效或查询类型不合适时返回 false。

这项配置作用于尚未发送的查询。先检查返回值,再调用 SendQueryUGCRequest;完成后读取所需数据并调用 ReleaseQueryUGCRequest。不要把设置成功当作最终查询成功。

相关站内接口

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

资料依据:Steamworks ISteamUGC 接口。