> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Services C API overview - PFSegments.h

> Services C API overview - PFSegments.h

## 函数

| 函数                                                                                                                                                           | 描述                                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [PFSegmentsClientGetPlayerSegmentsAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayersegmentsasync)                     | 列出玩家当前所属的所有细分。                                                                                                                                                       |
| [PFSegmentsClientGetPlayerSegmentsGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayersegmentsgetresult)             | 获取成功的 PFSegmentsClientGetPlayerSegmentsAsync 调用的结果。                                                                                                                  |
| [PFSegmentsClientGetPlayerSegmentsGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayersegmentsgetresultsize)     | 获取存储 ClientGetPlayerSegments 调用结果所需的字节大小。                                                                                                                            |
| [PFSegmentsClientGetPlayerTagsAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayertagsasync)                             | 从玩家配置文件中获取具有给定命名空间（可选）的所有标签。                                                                                                                                         |
| [PFSegmentsClientGetPlayerTagsGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayertagsgetresult)                     | 获取成功的 PFSegmentsClientGetPlayerTagsAsync 调用的结果。                                                                                                                      |
| [PFSegmentsClientGetPlayerTagsGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayertagsgetresultsize)             | 获取存储 ClientGetPlayerTags 调用结果所需的字节大小。                                                                                                                                |
| [PFSegmentsServerAddPlayerTagAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserveraddplayertagasync)                               | 将给定的标签添加到玩家配置文件。标签的命名空间将根据标签来源自动生成。                                                                                                                                  |
| [PFSegmentsServerGetAllSegmentsAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsasync)                           | 检索玩家细分定义数组。其结果可用于后续的 API 调用，例如需要细分 ID 的 GetPlayersInSegment。虽然细分名称可以更改，但该细分的 ID 不会更改。                                                                                |
| [PFSegmentsServerGetAllSegmentsGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsgetresult)                   | 获取成功的 PFSegmentsServerGetAllSegmentsAsync 调用的结果。                                                                                                                     |
| [PFSegmentsServerGetAllSegmentsGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsgetresultsize)           | 获取存储 ServerGetAllSegments 调用结果所需的字节大小。                                                                                                                               |
| [PFSegmentsServerGetPlayerSegmentsAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsasync)                     | 列出玩家当前所属的所有细分。                                                                                                                                                       |
| [PFSegmentsServerGetPlayerSegmentsGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsgetresult)             | 获取成功的 PFSegmentsServerGetPlayerSegmentsAsync 调用的结果。                                                                                                                  |
| [PFSegmentsServerGetPlayerSegmentsGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsgetresultsize)     | 获取存储 ServerGetPlayerSegments 调用结果所需的字节大小。                                                                                                                            |
| [PFSegmentsServerGetPlayersInSegmentAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentasync)                 | 允许分页浏览给定细分中的所有玩家。此 API 会创建在其创建时匹配细分定义的所有玩家配置文件的快照，并在“存留总秒数”期间持续存在，每次后续使用延续令牌都会刷新其生存期。在分页过程中发生更改的配置文件将不会反映在结果中。此操作目前不支持 AB 测试细分。注意：此 API 限制为每分钟调用 30 次。如果超过此阈值，将返回错误。 |
| [PFSegmentsServerGetPlayersInSegmentGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentgetresult)         | 获取成功的 PFSegmentsServerGetPlayersInSegmentAsync 调用的结果。                                                                                                                |
| [PFSegmentsServerGetPlayersInSegmentGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentgetresultsize) | 获取存储 ServerGetPlayersInSegment 调用结果所需的字节大小。                                                                                                                          |
| [PFSegmentsServerGetPlayerTagsAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync)                             | 从玩家配置文件中获取具有给定命名空间（可选）的所有标签。                                                                                                                                         |
| [PFSegmentsServerGetPlayerTagsGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresult)                     | 获取成功的 PFSegmentsServerGetPlayerTagsAsync 调用的结果。                                                                                                                      |
| [PFSegmentsServerGetPlayerTagsGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresultsize)             | 获取存储 ServerGetPlayerTags 调用结果所需的字节大小。                                                                                                                                |
| [PFSegmentsServerRemovePlayerTagAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserverremoveplayertagasync)                         | 从玩家配置文件中移除给定的标签。标签的命名空间将根据标签来源自动生成。                                                                                                                                  |


## Related topics

- [Services C API overview - PFSegmentsTypes.h](/zh-CN/services/playfab/api-references/c/pfsegmentstypes/pfsegmentstypes_members.md)
- [PFSegmentsClientGetPlayerSegmentsAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsclientgetplayersegmentsasync.md)
- [PFSegmentsServerGetAllSegmentsAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsasync.md)
- [PFSegmentsServerGetPlayerSegmentsAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsasync.md)
- [PFSegmentsServerGetPlayersInSegmentAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentasync.md)
