ISteamUGC::GetUserItemVote：读取用户对项目的投票

GetUserItemVote 用于异步读取当前用户对指定工坊项目的投票状态，供内容浏览界面显示。本页面向 Steamworks 游戏和工具开发者，说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

函数声明

客户端通过初始化成功后的 SteamUGC() 接口访问；游戏服务器使用服务器上下文的 SteamGameServerUGC()。以下声明按本次核对的官方接口整理，编译时应以项目实际使用的 SDK 头文件为准。

SteamAPICall_t GetUserItemVote( PublishedFileId_t nPublishedFileID );

参数

返回值与完成方式

返回 SteamAPICall_t；通过 GetUserItemVoteResult_t 检查结果和赞、踩、跳过等状态。

调用结果由 Steam 异步交付。应在对象有效期间保存对应的结果处理器，并持续运行 Steam 回调；还要区分传输失败与结果结构中的操作失败。

调用规则与排查

传入要查询的 PublishedFileId_t。官方页面该方法正文误出现下载说明，与函数名、签名及投票结果类型不一致；这里按投票调用解释，实际集成以 SDK 声明为准。查询成功后再更新界面，失败时避免把默认值误显示为用户选择。

使用场景

例如，游戏内项目详情页想展示当前用户是否赞过该项目，可以发起一次查询并在结果到达前显示等待状态。收到结果后核对项目 ID、操作结果和投票标记，再更新该详情页；玩家切换到其他项目时，也要避免把旧结果展示到新页面。

相关接口

SetUserItemVote。回调、状态与类型参考整理了相关结构体和枚举，适合在处理结果时对照使用。

站内字段参考

GetUserItemVoteResult_t。

资料依据：Steamworks ISteamUGC：GetUserItemVote。资料核对日期：2026 年 11 月 4 日。