PFSegmentsServerAddPlayerTagAsync - XBOX Game Development Documentation

将给定的标签添加到玩家配置文件。标签的命名空间将根据标签来源自动生成。

语法

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 服务错误。有关错误处理的详细信息，请参阅文档页面“Handling PlayFab Errors”。

要求

头文件： PFSegments.h

另请参阅

PFSegments 成员

​语法

​参数

​返回值

​备注

​要求

​另请参阅

语法

参数

返回值

备注

要求

另请参阅