SetCloudFileNameFilter：按云文件名筛选用户内容
ISteamUGC::SetCloudFileNameFilter 用于按云文件名筛选用户内容。本页面向 Steam 创意工坊浏览器与工具开发者，说明该调用的参数、结果以及它在查询流程中的使用条件。
函数声明
以下声明记录了当前参考页面的接口形式；不同 SDK 版本应以项目实际使用的头文件为准。通过初始化成功后的 SteamUGC() 访问该接口。
bool SetCloudFileNameFilter( UGCQueryHandle_t handle, const char *pMatchCloudFileName );
参数
| 参数 | 类型 | 说明 |
|---|---|---|
handle |
UGCQueryHandle_t |
输入：查询句柄，由创建查询的方法取得。 |
pMatchCloudFileName |
const char * |
输入：要匹配的云文件名。 |
返回与完成机制
返回 bool；设置成功为 true，失败为 false。设置成功只说明当前调用被接受，查询是否成功仍须检查异步完成结果。
调用规则与注意事项
传入需要匹配的文件名，在发送前设置。官方用途说明称仅用于用户查询，而同页失败条件却提到详情查询，两处存在冲突；应以当前 SDK 及实际目标环境验证。句柄无效或文件名指针为空时不可视为设置成功。
这项配置作用于尚未发送的查询。先检查返回值，再调用 SendQueryUGCRequest；完成后读取所需数据并调用 ReleaseQueryUGCRequest。不要把设置成功当作最终查询成功。
相关站内接口
CreateQueryUserUGCRequest、SendQueryUGCRequest；数据结构与枚举可参阅 回调、结构体与枚举。
资料依据：Steamworks ISteamUGC 接口。