使用英语阅读

通过

PFSegmentsServerAddPlayerTagAsync

  • 项目
  • 2024/11/19

向玩家档案添加给定标记。 根据标记的源自动生成标记的命名空间。

语法

HRESULT PFSegmentsServerAddPlayerTagAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFSegmentsAddPlayerTagRequest* request,  
    XAsyncBlock* async  
)

参数

titleEntityHandle PFEntityHandle

使用 PFAuthenticationGetEntityWithSecretKeyAsync 获取的游戏实体的 PFEntityHandle。

request PFSegmentsAddPlayerTagRequest*

已填充的请求对象。

async XAsyncBlock*
Inout

异步操作的 XAsyncBlock。

返回值

类型：HRESULT

此 API 操作的结果代码。

备注

此 API 在 Win32、Linux 和 macOS 上可用。 此 API 将会触发 player_tag_added 事件，并将具有给定 TagName 和 PlayFabID 的标记添加到相应的玩家配置文件。 TagName 可用于分段，并且限 256 个字符。 游戏可以拥有的标记数量也是有限的。 另请参阅 ServerGetPlayerTagsAsync、ServerRemovePlayerTagAsync。 调用 XAsyncGetStatus 以获取操作的状态。 如果服务调用不成功，则异步结果将为 E_PF_PLAYER_TAG_COUNT_LIMIT_EXCEEDED 或任何全局 PlayFab 服务错误。 有关错误处理的更多详细信息，请参阅文档页“处理 PlayFab 错误”。

要求

标头：PFSegments.h

另请参阅

PFSegments 成员